ZhouXY108/hutool
1
0
Fork 0
mirror of https://gitee.com/chinabugotech/hutool.git synced 2025-05-09 23:51:34 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix doc

Browse Source
This commit is contained in:
Looly 2022-08-09 22:48:40 +08:00
parent 3a08a399da
commit 719b5a226d
3 changed files with 27 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
hutool-core/src/main/java/cn/hutool/core/collection/ListUtil.java
View File

@ -699,6 +699,8 @@ public class ListUtil {
* 通过删除或替换现有元素或者原地添加新的元素来修改列表，并以列表形式返回被修改的内容。此方法不会改变原列表。
* 类似js的<a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/splice">splice</a>函数
*
* @param <T> 元素类型
* @param list 列表
* @param start 指定修改的开始位置（从 0 计数）, 可以为负数, -1代表最后一个元素
* @param deleteCount 删除个数，必须是正整数
* @param items 放入的元素

50
hutool-core/src/main/java/cn/hutool/core/date/DatePattern.java
View File

@ -12,36 +12,34 @@ import java.util.regex.Pattern;
* 日期格式化类，提供常用的日期格式化对象
*
* <p>所有的jdk日期格式模式字符串 jdk18 date format pattern
* <a href="https://docs.oracle.com/en/java/javase/18/docs/api/java.base/java/time/format/DateTimeFormatter.html">
* <i>jdk date format pattern （Pattern Letters and Symbols） 日期格式模式字符串</i>
* </a>
* <a href="https://docs.oracle.com/en/java/javase/18/docs/api/java.base/java/time/format/DateTimeFormatter.html">
* <i>jdk date format pattern （Pattern Letters and Symbols） 日期格式模式字符串</i>
* </a>
* </p>
*
* <h2>工具类，提供格式化字符串很多，但是对于具体什么含义，不够清晰，这里进行说明：</h2>
* <b>常见日期格式模式字符串：</b>
* <ul>
* <li>yyyy-MM-dd 示例：2022-08-05</li>
* <li>yyyy年MM月dd日 示例：2022年08月05日</li>
* <li>yyyy-MM-dd HH:mm:ss 示例：2022-08-05 12:59:59</li>
* <li>yyyy-MM-dd HH:mm:ss.SSS 示例：2022-08-05 12:59:59.559</li>
* <li>yyyy-MM-dd HH:mm:ss.SSSZ 示例：2022-08-05 12:59:59.559+0800, 年月日 时分秒 毫秒 时区</li>
* <li>yyyy-MM-dd HH:mm:ss.SSSz 示例：2022-08-05 12:59:59.559UTC+08:00,年月日 时分秒 毫秒 时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSS'Z' 示例：2022-08-05T12:59:59.559Z, 其中：''单引号表示转义字符，T:分隔符，Z:一般值UTC,0时区的时间含义</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSZ 示例：2022-08-05T11:59:59.559+0800, 其中：Z,表示时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSX 示例：2022-08-05T12:59:59.559+08, 其中：X:两位时区，+08表示：东8区，中国时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSXX 示例：2022-08-05T12:59:59.559+0800, 其中：XX:四位时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSXXX 示例：2022-08-05T12:59:59.559+08:00, 其中：XX:五位时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss 示例：2022-08-05T12:59:59+08</li>
* <li>yyyy-MM-dd'T'HH:mm:ssXXX 示例：2022-08-05T12:59:59+08:00</li>
* <li>yyyy-MM-dd'T'HH:mm:ssZ 示例：2022-08-05T12:59:59+0800</li>
* <li>yyyy-MM-dd'T'HH:mm:ss'Z' 示例：2022-08-05T12:59:59Z</li>
* <li>EEE MMM dd HH:mm:ss z yyyy 示例：周五 8月 05 12:59:00 UTC+08:00 2022</li>
* <li>EEE MMM dd HH:mm:ss zzz yyyy 示例：周五 8月 05 12:59:00 UTC+08:00 2022,其中z表示UTC时区，但：1~3个z没有任何区别</li>
* <li>EEE, dd MMM yyyy HH:mm:ss z 示例：周五, 05 8月 2022 12:59:59 UTC+08:00</li>
* </ul>
* <p>
* <b>常见日期格式模式字符串：</b>
* <ul>
* <li>yyyy-MM-dd 示例：2022-08-05</li>
* <li>yyyy年MM月dd日 示例：2022年08月05日</li>
* <li>yyyy-MM-dd HH:mm:ss 示例：2022-08-05 12:59:59</li>
* <li>yyyy-MM-dd HH:mm:ss.SSS 示例：2022-08-05 12:59:59.559</li>
* <li>yyyy-MM-dd HH:mm:ss.SSSZ 示例：2022-08-05 12:59:59.559+0800, 年月日 时分秒 毫秒 时区</li>
* <li>yyyy-MM-dd HH:mm:ss.SSSz 示例：2022-08-05 12:59:59.559UTC+08:00,年月日 时分秒 毫秒 时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSS'Z' 示例：2022-08-05T12:59:59.559Z, 其中：''单引号表示转义字符，T:分隔符，Z:一般值UTC,0时区的时间含义</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSZ 示例：2022-08-05T11:59:59.559+0800, 其中：Z,表示时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSX 示例：2022-08-05T12:59:59.559+08, 其中：X:两位时区，+08表示：东8区，中国时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSXX 示例：2022-08-05T12:59:59.559+0800, 其中：XX:四位时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss.SSSXXX 示例：2022-08-05T12:59:59.559+08:00, 其中：XX:五位时区</li>
* <li>yyyy-MM-dd'T'HH:mm:ss 示例：2022-08-05T12:59:59+08</li>
* <li>yyyy-MM-dd'T'HH:mm:ssXXX 示例：2022-08-05T12:59:59+08:00</li>
* <li>yyyy-MM-dd'T'HH:mm:ssZ 示例：2022-08-05T12:59:59+0800</li>
* <li>yyyy-MM-dd'T'HH:mm:ss'Z' 示例：2022-08-05T12:59:59Z</li>
* <li>EEE MMM dd HH:mm:ss z yyyy 示例：周五 8月 05 12:59:00 UTC+08:00 2022</li>
* <li>EEE MMM dd HH:mm:ss zzz yyyy 示例：周五 8月 05 12:59:00 UTC+08:00 2022,其中z表示UTC时区，但：1~3个z没有任何区别</li>
* <li>EEE, dd MMM yyyy HH:mm:ss z 示例：周五, 05 8月 2022 12:59:59 UTC+08:00</li>
* </ul>
* </p>
*
* 系统提供的，请查看，有大量定义好的格式化对象，可以直接使用，如：
* {@link DateTimeFormatter#ISO_DATE}
* {@link DateTimeFormatter#ISO_DATE_TIME}

5
hutool-core/src/main/java/cn/hutool/core/stream/FastStream.java
View File

@ -699,11 +699,8 @@ public class FastStream<T> implements Stream<T>, Iterable<T> {
}
/**
* 返回一个包含此流元素的指定的数组
* <p>
* 例如以下代码编译正常，但运行时会抛出 {@link ArrayStoreException}
* 返回一个包含此流元素的指定的数组，例如以下代码编译正常，但运行时会抛出 {@link ArrayStoreException}
* <pre>{@code String[] strings = Stream.<Integer>builder().add(1).build().toArray(String[]::new); }</pre>
* </p>
*
* @param generator 这里的IntFunction的参数是元素的个数，返回值为数组类型
* @param <A> 给定的数组类型