ZhouXY108/hutool
1
0
Fork 0
mirror of https://gitee.com/chinabugotech/hutool.git synced 2025-04-19 03:01:48 +08:00
Code Issues Packages Projects Releases Wiki Activity

DatePattern增加：对UTC时间详细说明，易错，易混淆。

Browse Source
This commit is contained in:
duandazhi 2022-08-23 04:13:07 -04:00
parent e0172b9500
commit 755cb0de26
1 changed files with 17 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -26,8 +26,8 @@ import java.util.regex.Pattern;
* <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 示例：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.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.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+08:00,年月日 时分秒 毫秒 时区</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.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.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.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}
* {@link DateTimeFormatter#ISO_DATE_TIME} * {@link DateTimeFormatter#ISO_DATE_TIME}
* 查看更多，请参阅上述官方文档 * 查看更多，请参阅上述官方文档
* </p>
* *
* <br/>
* 其中：CST格式，形如："Mon Aug 15 14:23:15 CST 2022",上面未包含 * 其中：CST格式，形如："Mon Aug 15 14:23:15 CST 2022",上面未包含
* 参见：{@link CSTDateParser#parse(String)}、{@link DateUtil#parse(String, String...)}、{@link Date#toString()}进行处理 * 参见：{@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 * @author Looly
*/ */
public class DatePattern { public class DatePattern {