From 755cb0de26b1ac1a9692d9bd00226f67830a95dd Mon Sep 17 00:00:00 2001
From: duandazhi <ab601026460@163.com>
Date: Tue, 23 Aug 2022 04:13:07 -0400
Subject: [PATCH] =?UTF-8?q?DatePattern=E5=A2=9E=E5=8A=A0=EF=BC=9A=E5=AF=B9?=
 =?UTF-8?q?UTC=E6=97=B6=E9=97=B4=E8=AF=A6=E7=BB=86=E8=AF=B4=E6=98=8E?=
 =?UTF-8?q?=EF=BC=8C=E6=98=93=E9=94=99=EF=BC=8C=E6=98=93=E6=B7=B7=E6=B7=86?=
 =?UTF-8?q?=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../java/cn/hutool/core/date/DatePattern.java | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 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 9b97f721c..6cf7996ad 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
@@ -26,8 +26,8 @@ import java.util.regex.Pattern;
  *    <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 HH:mm:ss.SSSZ     示例：2022-08-05 12:59:59.559+0800【东八区中国时区】、2022-08-05 04:59:59.559+0000【冰岛0时区】, 年月日 时分秒 毫秒 时区</li>
+ *    <li>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】 ,年月日 时分秒 毫秒 时区</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>
@@ -46,10 +46,25 @@ import java.util.regex.Pattern;
  * {@link DateTimeFormatter#ISO_DATE}
  * {@link DateTimeFormatter#ISO_DATE_TIME}
  * 查看更多，请参阅上述官方文档
+ * </p>
  *
+ * <br/>
  * 其中：CST格式，形如："Mon Aug 15 14:23:15 CST 2022",上面未包含
  * 参见：{@link CSTDateParser#parse(String)}、{@link DateUtil#parse(String, String...)}、{@link Date#toString()}进行处理
  *
+ * <p>
+ * 特殊说明：UTC时间，世界标准时间，0时区的时间，伦敦时间，可以直接加Z表示不加空格，
+ * 如：“09:30 UTC”表示为“09:30Z”或“T0930Z”，其中：Z 是 +00:00 的缩写，意思是 UTC(零时分秒的偏移量).
+ * <ul>
+ *     <li>yyyy-MM-dd'T'HH:mm:ssZ</li>
+ *     <li>正确示例：2022-08-23T15:20:46UTC</li>
+ *     <li>正确示例：2022-08-23T15:20:46 UTC</li>
+ *     <li>正确示例：2022-08-23T15:20:46+0000</li>
+ *     <li>正确示例：2022-08-23T15:20:46 +0000</li>
+ *     <li>错误示例：2022-08-23T15:20:46Z，必须把“String dateTimeStr = dateTimeStr.replace("Z", " UTC");”</li>
+ * </ul>
+ * </p>
+ *
  * @author Looly
  */
 public class DatePattern {