SimpleDateFormat类所在java包位置&＃xff1a;java.text.SimpleDateFormat。继承结构如下&＃xff1a;


• java.lang.Object

• java.text.Format

• java.text.DateFormat

• java.text.SimpleDateFormat

且实现了Serializable, Cloneable接口。


SimpleDateFormat类简介

SimpleDataFormat类可用于格式化、解析带区域的日期&＃xff0c;可将日期格式转为文本&＃xff0c;可将文本解析为日期&＃xff0c;还可以进行日期规范化。

SimpleDataFormat类支持用户自定义日期格式&＃xff0c;同时也提供一些内置的日期格式&＃xff0c;例如可通过getTimeInstance、getDateInstance或DateFormat中的getDateTimeInstance获取内置日期格式。上述方法都会返回一个用默认格式的Date/Time类型对象。更多使用方法参考DateFomat类。

日期和时间的格式

日期和时间的格式可以通过String类型的格式指定&＃xff0c;格式字母解释如下表所示&＃xff1a;

字母	日期	表示类型	例子
G	表示纪元时代	Text	AD或BC
y	年	Year	1996; 96
Y	周年	Year	2009; 09
M	一年中的月&＃xff08;上下文相关&＃xff09;	Month	July; Jul; 07
L	一年中的月&＃xff08;独立形式&＃xff09;	Month	July; Jul; 07
w	一年中的第几周	Number	27
W	月中的第几周	Number	2
D	一年中的第几天	Number	189
d	一月中的第几天	Number	10
F	月份中的第几天	Number	2
E	月份中的周几	Text	Tuesday; Tue
u	一周中的第几天&＃xff08;1&＃61;周一&＃xff0c;...&＃xff0c;7&＃61;周日&＃xff09;	Number	1
a	Am/pm 标记	Text	PM
H	一天的几时 (0-23)--表示法1	Number	0
k	一天的几时 (1-24)--表示法2	Number	24
K	am/pm 中的几时(0-11)	Number	0
h	am/pm 中的几时(1-12)	Number	12
m	小时中的分钟	Number	30
s	分钟下的秒	Number	55
S	毫秒	Number	978
z	时区&＃xff08;指定时区&＃xff0c;例如&＃xff1a;PST、GMT-08:00&＃xff09;	General time zone	Pacific Standard Time; PST; GMT-08:00
Z	时区&＃xff08;RFC 822日期格式&＃xff09;	RFC 822 time zone	-0800
X	时区&＃xff08;ISO 8601标准日期格式&＃xff09;	ISO 8601 time zone	-08; -0800; -08:00

注&＃xff1a;

纪元AD、BC&＃xff1a;BC&＃xff08;Before Christ&＃xff09;表示公元前&＃xff08;耶稣诞生之前&＃xff09;&＃xff0c;AD&＃xff08;Anno Domini&＃xff09;表示公元年。

太平洋标准时间&＃xff08;PST&＃xff09;&＃xff1a;比世界标准时间&＃xff08;UTC&＃xff09;晚8小时&＃xff0c;比北京时间&＃xff08;UT&＃43;8:00&＃xff09;晚16小时。加拿大、墨西哥、美国在使用。GMT为格林尼治时区时间。

ISO 8601&＃xff1a;全世界日期和时间相关的数据交换的国际标准。这个标准的目标是在全世界范围的通信中提供格式良好的、无歧义的时间和日期表示。

日期格式举例&＃xff08;地理位置为美国&＃xff0c;时区为PST&＃xff09;

给定时间 2001-07-04 12:08:56&＃xff0c;不同的日期时间格式解析的结果如下&＃xff1a;

日期时间格式	结果
"yyyy.MM.dd G &＃39;at&＃39; HH:mm:ss z"	2001.07.04 AD at 12:08:56 PDT
"EEE, MMM d, &＃39;&＃39;yy"	Wed, Jul 4, &＃39;01
"h:mm a"	12:08 PM
"hh &＃39;o&＃39;&＃39;clock&＃39; a, zzzz"	12 o&＃39;clock PM, Pacific Daylight Time
"K:mm a, z"	0:08 PM, PDT
"yyyyy.MMMMM.dd GGG hh:mm aaa"	02001.July.04 AD 12:08 PM
"EEE, d MMM yyyy HH:mm:ss Z"	Wed, 4 Jul 2001 12:08:56 -0700
"yyMMddHHmmssZ"	010704120856-0700
"yyyy-MM-dd&＃39;T&＃39;HH:mm:ss.SSSZ"	2001-07-04T12:08:56.235-0700
"yyyy-MM-dd&＃39;T&＃39;HH:mm:ss.SSSXXX"	2001-07-04T12:08:56.235-07:00
"YYYY-&＃39;W&＃39;ww-u"	2001-W27-3

线程安全性

该类并未加入同步操作&＃xff0c;因此非线程安全。推荐为每个线程单独创建一个SimpleDateFormat对象&＃xff0c;如果多线程同步访问一个SimpleDateFormat共享对象时&＃xff0c;必须额外做好同步操作。

推荐使用线程本地解决SimpleDateFormat非线程安全问题&＃xff0c;示例&＃xff1a;

privatestaticfinal ThreadLocal sdfThreadLocal &＃61; ThreadLocal.withInitial(()->{
SimpleDateFormatsdf&＃61;newSimpleDateFormat("yyyy-MM-dd HH:mm:ss");
return sdf;
});
publicstaticvoidmain(String[] args){
newThread(()->{
while (true){
try{
Thread.sleep(1000);
System.out.println(Thread.currentThread().getName()&＃43;": "&＃43;sdfThreadLocal.get().format(newDate()));
}catch (InterruptedException e){
e.printStackTrace();
}
}
},"thread-1").start();
newThread(()->{
while (true){
try{
Thread.sleep(1000);
System.out.println(Thread.currentThread().getName()&＃43;": "&＃43;sdfThreadLocal.get().format(newDate()));
}catch (InterruptedException e){
e.printStackTrace();
}
}
},"thread-2").start();
}


输出&＃xff1a;

thread-2: 2022-05-19 20:50:23

thread-1: 2022-05-19 20:50:23

thread-1: 2022-05-19 20:50:24

thread-2: 2022-05-19 20:50:24

thread-1: 2022-05-19 20:50:25

thread-2: 2022-05-19 20:50:25

thread-1: 2022-05-19 20:50:26

方法介绍

&＃xff08;1&＃xff09;构造方法

public SimpleDateFormat()

使用默认日期格式&＃xff0c;默认格式地理位置。注意&＃xff1a;该方法不支持所有的地理位置&＃xff0c;可使用DateFormat的工厂方法替代。

SimpleDateFormat(String pattern)

使用给定的patter日期格式&＃xff0c;默认格式地理位置。注意&＃xff1a;该方法不支持所有的地理位置&＃xff0c;可使用DateFormat的工厂方法替代。

该方法等同于SimpleDateFormat(pattern, Locale.getDefault(Locale.Category.FORMAT)).

SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols)

使用给定的pattern和日期符号。formatSymbols表示用于格式化的日期符号。

SimpleDateFormat(String pattern, Locale locale)

使用给定的日期格式&＃xff0c;给定的默认地理位置格式。注意&＃xff1a;该方法不支持所有的地理位置&＃xff0c;可使用DateFormat的工厂方法替代。

最后三个构造方法存在的异常&＃xff1a;

NullPointerException - 给定pattern为空

IllegalArgumentException - 给定pattern非法

&＃xff08;2&＃xff09;常用方法

该类继承自DateFormat类&＃xff0c;拥有后者的全部共有方法。

链接&＃xff1a;https://juejin.cn/post/7099429949588635662