扎心了!新年遇到的第一個(gè)Bug!
2019 年最后一天,在家里看著跨年晚會(huì),享受著這一年最后一天的閑暇時(shí)光,女朋友在旁邊玩手機(jī)??戳艘粫?huì)之后她突然問(wèn)我一些很奇怪的問(wèn)題。
圖片來(lái)自 Pexels
于是我拿過(guò)她的手機(jī),看到了下面這一幕:
這是微信官方出的公眾號(hào)管理的 App,上面赫然寫(xiě)著一篇文章的發(fā)文日期是 2020/12/29。
SimpleDateFormat
SimpleDateFormat 是 Java 提供的一個(gè)格式化和解析日期的工具類(lèi)。它允許進(jìn)行格式化(日期→文本)、解析(文本→日期)和規(guī)范化。
SimpleDateFormat 使得可以選擇任何用戶定義的日期-時(shí)間格式的模式。
在 Java 中,可以使用 SimpleDateFormat 的 format 方法,將一個(gè) Date 類(lèi)型轉(zhuǎn)化成 String 類(lèi)型,并且可以指定輸出格式。
- // Date轉(zhuǎn)String
- Date data = new Date();
- SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
- String dataStr = sdf.format(data);
- System.out.println(dataStr);
以上代碼,轉(zhuǎn)換的結(jié)果是:2018-11-25 13:00:00,日期和時(shí)間格式由“日期和時(shí)間模式”字符串指定。如果你想要轉(zhuǎn)換成其他格式,只要指定不同的時(shí)間模式就行了。
在 Java 中,可以使用 SimpleDateFormat 的 parse 方法,將一個(gè) String 類(lèi)型轉(zhuǎn)化成 Date 類(lèi)型。
- // String轉(zhuǎn)Data
- System.out.println(sdf.parse(dataStr));
日期和時(shí)間模式表達(dá)方法
在使用 SimpleDateFormat 的時(shí)候,需要通過(guò)字母來(lái)描述時(shí)間元素,并組裝成想要的日期和時(shí)間模式。
常用的時(shí)間元素和字母的對(duì)應(yīng)表(JDK 1.8)如下:

模式字母通常是重復(fù)的,其數(shù)量確定其精確表示。如前面我們用過(guò)的"yyyy-MM-dd HH:mm:ss"。
什么是 Week Year
我們知道,不同的國(guó)家對(duì)于一周的開(kāi)始和結(jié)束的定義是不同的。如在中國(guó),我們把星期一作為一周的第一天,而在美國(guó),他們把星期日作為一周的第一天。
同樣,如何定義哪一周是一年當(dāng)中的第一周?這也是一個(gè)問(wèn)題,有很多種方式。
比如下圖是 2019 年 12 月-2020 年 1 月的一份日歷:
到底哪一周才算 2020 年的第一周呢?不同的地區(qū)和國(guó)家,甚至不同的人,都有不同的理解:
- 1 月 1 日是周三,到下周三(1 月 8 日),這 7 天算作這一年的第一周。
- 因?yàn)橹苋?周一)才是一周的第一天,所以,要從 2020 年的第一個(gè)周日(周一)開(kāi)始往后推 7 天才算這一年的第一周。
- 因?yàn)?12.29、12.30、12.31 是 2019 年,而 1.1、1.2、1.3 才是 2020 年,而 1.4 周日是下一周的開(kāi)始,所以,第一周應(yīng)該只有 1.1、1.2、1.3 這三天。
ISO 8601
因?yàn)椴煌藢?duì)于日期和時(shí)間的表示方法有不同的理解,于是,大家就共同制定了了一個(gè)國(guó)際規(guī)范:ISO 8601 。
國(guó)際標(biāo)準(zhǔn)化組織的國(guó)際標(biāo)準(zhǔn) ISO 8601 是日期和時(shí)間的表示方法,全稱(chēng)為《數(shù)據(jù)存儲(chǔ)和交換形式·信息交換·日期和時(shí)間的表示方法》。
在 ISO 8601 中,對(duì)于一年的第一個(gè)日歷星期有以下四種等效說(shuō)法:
- 本年度第一個(gè)星期四所在的星期。
- 1 月 4 日所在的星期。
- 本年度第一個(gè)至少有 4 天在同一星期內(nèi)的星期。
- 星期一在去年 12 月 29 日至今年 1 月 4 日以內(nèi)的星期。
根據(jù)這個(gè)標(biāo)準(zhǔn),我們可以推算出:2020 年第一周:2019.12.29-2020.1.4。
所以,根據(jù) ISO 8601 標(biāo)準(zhǔn),2019 年 12 月 29 日、2019 年 12 月 30 日、2019 年 12 月 31 日這三天,其實(shí)不屬于 2019 年的最后一周,而是屬于 2020 年的第一周。
JDK 針對(duì) ISO 8601 提供的支持
根據(jù) ISO 8601 中關(guān)于日歷星期和日表示法的定義,2019.12.29-2020.1.4 是 2020 年的第一周。
日常工作中,我們可能有這樣的需求:我們希望輸入一個(gè)日期,然后程序告訴我們,根據(jù) ISO 8601 中關(guān)于日歷日期的定義,這個(gè)日期到底屬于哪一年。
比如我輸入 2019-12-20,他告訴我是 2019;而我輸入 2019-12-30 的時(shí)候,他告訴我是 2020。
為了提供這樣的數(shù)據(jù),Java 7 引入了「YYYY」作為一個(gè)新的日期模式來(lái)作為標(biāo)識(shí)。
使用「YYYY」作為標(biāo)識(shí),再通過(guò) SimpleDateFormat 就可以得到一個(gè)日期所屬的周屬于哪一年了。
所以,我們通過(guò)代碼可以驗(yàn)證:
- public class WeekYearTest {
- public static void main(String[] args) {
- SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
- SimpleDateFormat sdf1 = new SimpleDateFormat("YYYY");
- System.out.println(sdf1.format(sdf.parse("2019-12-01")));
- System.out.println(sdf1.format(sdf.parse("2019-12-30")));
- System.out.println(sdf1.format(sdf.parse("2020-01-01")));
- }
- }
輸出結(jié)果為:
- 2019
- 2020
- 2020
可見(jiàn), 2019-12-30 日因?yàn)閷儆?2020 年的第一周,所以返回的年份是 2020 年。
而如果將「YYYY」改成「yyyy」的話,輸出結(jié)果就為:
- 2019
- 2019
- 2020
因?yàn)橛羞@樣的情況,所以我們?nèi)粘i_(kāi)發(fā)的時(shí)候,如果把 y 寫(xiě)成了 Y,那就可能導(dǎo)致日期輸出的結(jié)果不符合我們的預(yù)期。
當(dāng)我們要表示日期的時(shí)候,一定要使用 yyyy-MM-dd 而不是 YYYY-MM-dd ,這兩者的返回結(jié)果大多數(shù)情況下都一樣,但是極端情況就會(huì)有問(wèn)題了。
因?yàn)樽髡叩?IDEA 中安裝了<阿里巴巴開(kāi)發(fā)手冊(cè)的插件>,所以在代碼中使用「YYYY」的時(shí)候,IDEA 會(huì)彈出以下提示:
好啦,大家快去排查下你的代碼,有沒(méi)有'YYYY-MM-dd'這種形式的代碼吧,如果有的話,一定要改掉哦!~