From 14351aa7254345b3b264e74315801dde0ca5b838 Mon Sep 17 00:00:00 2001 From: emptypoint <1215582715@qq.com> Date: Sun, 1 Jan 2023 11:30:19 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E4=BF=AE=E5=A4=8Djavadoc=E9=97=AE=E9=A2=98?= =?UTF-8?q?;?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../java/cn/hutool/core/date/DatePattern.java | 44 +++++++++++-------- 1 file changed, 25 insertions(+), 19 deletions(-) diff --git a/hutool-core/src/main/java/cn/hutool/core/date/DatePattern.java b/hutool-core/src/main/java/cn/hutool/core/date/DatePattern.java index 15585134b..b59eea778 100644 --- a/hutool-core/src/main/java/cn/hutool/core/date/DatePattern.java +++ b/hutool-core/src/main/java/cn/hutool/core/date/DatePattern.java @@ -30,7 +30,7 @@ import java.util.regex.Pattern; *
  • yyyy-MM-dd HH:mm:ss 示例：2022-08-05 12:59:59
    • *
  • yyyy-MM-dd HH:mm:ss.SSS 示例：2022-08-05 12:59:59.559
    • *
  • yyyy-MM-dd HH:mm:ss.SSSZ 示例：2022-08-05 12:59:59.559+0800【东八区中国时区】、2022-08-05 04:59:59.559+0000【冰岛0时区】, 年月日 时分秒 毫秒 时区
    • - *
  • yyyy-MM-dd HH:mm:ss.SSSz 示例：2022-08-05 12:59:59.559UTC【世界标准时间=0时区】、2022-08-05T12:59:59.599GMT【冰岛0时区】、2022-08-05T12:59:59.599CST【东八区中国时区】、2022-08-23T03:45:00EDT【美国东北纽约时间，-0400】 ,年月日 时分秒 毫秒 时区
    • + *
  • yyyy-MM-dd HH:mm:ss.SSSz 示例：2022-08-05 12:59:59.559UTC【世界标准时间=0时区】、2022-08-05T12:59:59.599GMT【冰岛0时区】、2022-08-05T12:59:59.599CST【东八区中国时区】、2022-08-23T03:45:00.599EDT【美国东北纽约时间，-0400】 ,年月日 时分秒 毫秒 时区
    • *
  • yyyy-MM-dd'T'HH:mm:ss.SSS'Z' 示例：2022-08-05T12:59:59.559Z, 其中：''单引号表示转义字符，T:分隔符，Z:一般值UTC,0时区的时间含义
    • *
  • yyyy-MM-dd'T'HH:mm:ss.SSSZ 示例：2022-08-05T11:59:59.559+0800, 其中：Z,表示时区
    • *
  • yyyy-MM-dd'T'HH:mm:ss.SSSX 示例：2022-08-05T12:59:59.559+08, 其中：X:两位时区，+08表示：东8区，中国时区
    • @@ -89,7 +89,8 @@ public class DatePattern { */ public static final Pattern REGEX_NORM = Pattern.compile("\\d{4}-\\d{1,2}-\\d{1,2}(\\s\\d{1,2}:\\d{1,2}(:\\d{1,2})?)?(.\\d{1,6})?"); - //-------------------------------------------------------------------------------------------------------------------------------- Normal + // region Normal + //================================================== Normal ================================================== /** * 年格式：yyyy */ @@ -103,7 +104,7 @@ public class DatePattern { */ public static final FastDateFormat NORM_MONTH_FORMAT = FastDateFormat.getInstance(NORM_MONTH_PATTERN); /** - * 年月格式 {@link FastDateFormat}：yyyy-MM + * 年月格式 {@link DateTimeFormatter}：yyyy-MM */ public static final DateTimeFormatter NORM_MONTH_FORMATTER = createFormatter(NORM_MONTH_PATTERN); @@ -116,7 +117,7 @@ public class DatePattern { */ public static final FastDateFormat SIMPLE_MONTH_FORMAT = FastDateFormat.getInstance(SIMPLE_MONTH_PATTERN); /** - * 简单年月格式 {@link FastDateFormat}：yyyyMM + * 简单年月格式 {@link DateTimeFormatter}：yyyyMM */ public static final DateTimeFormatter SIMPLE_MONTH_FORMATTER = createFormatter(SIMPLE_MONTH_PATTERN); @@ -129,7 +130,7 @@ public class DatePattern { */ public static final FastDateFormat NORM_DATE_FORMAT = FastDateFormat.getInstance(NORM_DATE_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyy-MM-dd + * 标准日期格式 {@link DateTimeFormatter}：yyyy-MM-dd */ public static final DateTimeFormatter NORM_DATE_FORMATTER = createFormatter(NORM_DATE_PATTERN); @@ -142,7 +143,7 @@ public class DatePattern { */ public static final FastDateFormat NORM_TIME_FORMAT = FastDateFormat.getInstance(NORM_TIME_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：HH:mm:ss + * 标准日期格式 {@link DateTimeFormatter}：HH:mm:ss */ public static final DateTimeFormatter NORM_TIME_FORMATTER = createFormatter(NORM_TIME_PATTERN); @@ -155,7 +156,7 @@ public class DatePattern { */ public static final FastDateFormat NORM_DATETIME_MINUTE_FORMAT = FastDateFormat.getInstance(NORM_DATETIME_MINUTE_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyy-MM-dd HH:mm + * 标准日期格式 {@link DateTimeFormatter}：yyyy-MM-dd HH:mm */ public static final DateTimeFormatter NORM_DATETIME_MINUTE_FORMATTER = createFormatter(NORM_DATETIME_MINUTE_PATTERN); @@ -168,7 +169,7 @@ public class DatePattern { */ public static final FastDateFormat NORM_DATETIME_FORMAT = FastDateFormat.getInstance(NORM_DATETIME_PATTERN); /** - * 标准日期时间格式，精确到秒 {@link FastDateFormat}：yyyy-MM-dd HH:mm:ss + * 标准日期时间格式，精确到秒 {@link DateTimeFormatter}：yyyy-MM-dd HH:mm:ss */ public static final DateTimeFormatter NORM_DATETIME_FORMATTER = createFormatter(NORM_DATETIME_PATTERN); @@ -181,7 +182,7 @@ public class DatePattern { */ public static final FastDateFormat NORM_DATETIME_MS_FORMAT = FastDateFormat.getInstance(NORM_DATETIME_MS_PATTERN); /** - * 标准日期时间格式，精确到毫秒 {@link FastDateFormat}：yyyy-MM-dd HH:mm:ss.SSS + * 标准日期时间格式，精确到毫秒 {@link DateTimeFormatter}：yyyy-MM-dd HH:mm:ss.SSS */ public static final DateTimeFormatter NORM_DATETIME_MS_FORMATTER = createFormatter(NORM_DATETIME_MS_PATTERN); @@ -194,7 +195,7 @@ public class DatePattern { */ public static final FastDateFormat ISO8601_FORMAT = FastDateFormat.getInstance(ISO8601_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyy-MM-dd HH:mm:ss,SSS + * 标准日期格式 {@link DateTimeFormatter}：yyyy-MM-dd HH:mm:ss,SSS */ public static final DateTimeFormatter ISO8601_FORMATTER = createFormatter(ISO8601_PATTERN); @@ -207,12 +208,12 @@ public class DatePattern { */ public static final FastDateFormat CHINESE_DATE_FORMAT = FastDateFormat.getInstance(CHINESE_DATE_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyy年MM月dd日 + * 标准日期格式 {@link DateTimeFormatter}：yyyy年MM月dd日 */ public static final DateTimeFormatter CHINESE_DATE_FORMATTER = createFormatter(CHINESE_DATE_PATTERN); /** - * 标准日期格式：yyyy年MM月dd日 HH时mm分ss秒 + * 标准日期格式：yyyy年MM月dd日HH时mm分ss秒 */ public static final String CHINESE_DATE_TIME_PATTERN = "yyyy年MM月dd日HH时mm分ss秒"; /** @@ -220,11 +221,13 @@ public class DatePattern { */ public static final FastDateFormat CHINESE_DATE_TIME_FORMAT = FastDateFormat.getInstance(CHINESE_DATE_TIME_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyy年MM月dd日HH时mm分ss秒 + * 标准日期格式 {@link DateTimeFormatter}：yyyy年MM月dd日HH时mm分ss秒 */ public static final DateTimeFormatter CHINESE_DATE_TIME_FORMATTER = createFormatter(CHINESE_DATE_TIME_PATTERN); + // endregion - //-------------------------------------------------------------------------------------------------------------------------------- Pure + // region Pure + //================================================== Pure ================================================== /** * 标准日期格式：yyyyMMdd */ @@ -234,7 +237,7 @@ public class DatePattern { */ public static final FastDateFormat PURE_DATE_FORMAT = FastDateFormat.getInstance(PURE_DATE_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyyMMdd + * 标准日期格式 {@link DateTimeFormatter}：yyyyMMdd */ public static final DateTimeFormatter PURE_DATE_FORMATTER = createFormatter(PURE_DATE_PATTERN); @@ -247,7 +250,7 @@ public class DatePattern { */ public static final FastDateFormat PURE_TIME_FORMAT = FastDateFormat.getInstance(PURE_TIME_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：HHmmss + * 标准日期格式 {@link DateTimeFormatter}：HHmmss */ public static final DateTimeFormatter PURE_TIME_FORMATTER = createFormatter(PURE_TIME_PATTERN); @@ -260,7 +263,7 @@ public class DatePattern { */ public static final FastDateFormat PURE_DATETIME_FORMAT = FastDateFormat.getInstance(PURE_DATETIME_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyyMMddHHmmss + * 标准日期格式 {@link DateTimeFormatter}：yyyyMMddHHmmss */ public static final DateTimeFormatter PURE_DATETIME_FORMATTER = createFormatter(PURE_DATETIME_PATTERN); @@ -273,7 +276,7 @@ public class DatePattern { */ public static final FastDateFormat PURE_DATETIME_MS_FORMAT = FastDateFormat.getInstance(PURE_DATETIME_MS_PATTERN); /** - * 标准日期格式 {@link FastDateFormat}：yyyyMMddHHmmssSSS
    + * 标准日期格式 {@link DateTimeFormatter}：yyyyMMddHHmmssSSS
    * see https://stackoverflow.com/questions/22588051/is-java-time-failing-to-parse-fraction-of-second * jdk8 bug at: https://bugs.openjdk.java.net/browse/JDK-8031085 */ @@ -281,8 +284,10 @@ public class DatePattern { .appendPattern(DatePattern.PURE_DATETIME_PATTERN) .appendValue(ChronoField.MILLI_OF_SECOND, 3) .toFormatter(); + // endregion - //-------------------------------------------------------------------------------------------------------------------------------- Others + // region Others + //================================================== Others ================================================== /** * HTTP头中日期时间格式：EEE, dd MMM yyyy HH:mm:ss z */ @@ -372,6 +377,7 @@ public class DatePattern { * UTC时间{@link FastDateFormat}：yyyy-MM-dd'T'HH:mm:ss.SSSXXX */ public static final FastDateFormat UTC_MS_WITH_XXX_OFFSET_FORMAT = FastDateFormat.getInstance(UTC_MS_WITH_XXX_OFFSET_PATTERN); + // endregion /** * 创建并为 {@link DateTimeFormatter} 赋予默认时区和位置信息，默认值为系统默认值。 From d2604ea0009a94b0aa898d5505ffde9a78ade640 Mon Sep 17 00:00:00 2001 From: emptypoint <1215582715@qq.com> Date: Sun, 1 Jan 2023 13:16:34 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E4=BF=AE=E5=A4=8Djavadoc=E9=97=AE=E9=A2=98?= =?UTF-8?q?;?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- hutool-core/src/main/java/cn/hutool/core/date/Month.java | 3 ++- .../src/main/java/cn/hutool/core/text/dfa/WordTree.java | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/hutool-core/src/main/java/cn/hutool/core/date/Month.java b/hutool-core/src/main/java/cn/hutool/core/date/Month.java index 5f5518421..edd00e75d 100644 --- a/hutool-core/src/main/java/cn/hutool/core/date/Month.java +++ b/hutool-core/src/main/java/cn/hutool/core/date/Month.java @@ -124,7 +124,8 @@ public enum Month { } /** - * 获取此月份最后一天的值，不支持的月份（例如UNDECIMBER）返回-1 + * 获取此月份最后一天的值
    + * 不支持 {@link #UNDECIMBER}
    * * @param isLeapYear 是否闰年 * @return 此月份最后一天的值 diff --git a/hutool-core/src/main/java/cn/hutool/core/text/dfa/WordTree.java b/hutool-core/src/main/java/cn/hutool/core/text/dfa/WordTree.java index 5c435c138..af0c516fe 100755 --- a/hutool-core/src/main/java/cn/hutool/core/text/dfa/WordTree.java +++ b/hutool-core/src/main/java/cn/hutool/core/text/dfa/WordTree.java @@ -17,7 +17,7 @@ import java.util.function.Predicate; * DFA单词树（以下简称单词树），常用于在某大段文字中快速查找某几个关键词是否存在。
    * 单词树使用group区分不同的关键字集合，不同的分组可以共享树枝，避免重复建树。
    * 单词树使用树状结构表示一组单词。
    - * 例如：红领巾，红河构建树后为：
    + * 例如：红领巾，红河 构建树后为：
    * 红
    * / \
    * 领 河