為什么阿里巴巴要求日期格式化時必須有使用y表示年,而不能用Y?
在Java中進行日期處理大家一定都不陌生,我們經(jīng)常會需要在代碼中進行日期的轉(zhuǎn)換、日期的格式化等操作。
而一般我們進行日期格式化的時候都會使用SimpleDateFormat工具,之前我們有一篇文章介紹過SimpleDateFormat的線程安全問題(https://www.hollischuang.com/archives/3017),這一篇文章再來介紹一個和SimpleDateFormat有關,很容易被忽視,而一旦忽視可能導致大故障的問題。
SimpleDateFormat
SimpleDateFormat是Java提供的一個格式化和解析日期的工具類。它允許進行格式化(日期 -> 文本)、解析(文本 -> 日期)和規(guī)范化。SimpleDateFormat 使得可以選擇任何用戶定義的日期-時間格式的模式。
在Java中,可以使用SimpleDateFormat的format方法,將一個Date類型轉(zhuǎn)化成String類型,并且可以指定輸出格式。
- // 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,日期和時間格式由”日期和時間模式”字符串指定。如果你想要轉(zhuǎn)換成其他格式,只要指定不同的時間模式就行了。
在Java中,可以使用SimpleDateFormat的parse方法,將一個String類型轉(zhuǎn)化成Date類型。
- // String轉(zhuǎn)Data
- System.out.println(sdf.parse(dataStr));
日期和時間模式表達方法
在使用SimpleDateFormat的時候,需要通過字母來描述時間元素,并組裝成想要的日期和時間模式。常用的時間元素和字母的對應表(JDK 1.8)如下:
模式字母通常是重復的,其數(shù)量確定其精確表示。如前面我們用過的"yyyy-MM-dd HH:mm:ss"。我們知道其中的y其實是year的縮寫,所以我們都知道使用y來表示年,默認情況下,我們都會使用y而不是Y,那么這兩者之間有何區(qū)別呢?一旦用錯了會帶來什么后果呢?
其實在規(guī)定中,y表示year,而Y表示W(wǎng)eek Year!
什么是Week Year
我們知道,不同的國家對于一周的開始和結(jié)束的定義是不同的。如在中國,我們把星期一作為一周的第一天,而在美國,他們把星期日作為一周的第一天。
同樣,如何定義哪一周是一年當中的第一周?這也是一個問題,有很多種方式。
比如下圖是2019年12月-2020年1月的一份日歷。
到底哪一周才算2020年的第一周呢?不同的地區(qū)和國家,甚至不同的人,都有不同的理解。
- 1、1月1日是周三,到下周三(1月8日),這7天算作這一年的第一周。
- 2、因為周日(周一)才是一周的第一天,所以,要從2020年的第一個周日(周一)開始往后推7天才算這一年的第一周。
- 3、因為12.29、12.30、12.31是2019年,而1.1、1.2、1.3才是2020年,而1.4周日是下一周的開始,所以,第一周應該只有1.1、1.2、1.3這三天。
ISO 8601
因為不同人對于日期和時間的表示方法有不同的理解,于是,大家就共同制定了了一個國際規(guī)范:ISO 8601 。
國際標準化組織的國際標準ISO 8601是日期和時間的表示方法,全稱為《數(shù)據(jù)存儲和交換形式·信息交換·日期和時間的表示方法》。
在 ISO 8601中。對于一年的第一個日歷星期有以下四種等效說法:1,本年度第一個星期四所在的星期;2,1月4日所在的星期;3,本年度第一個至少有4天在同一星期內(nèi)的星期;4,星期一在去年12月29日至今年1月4日以內(nèi)的星期;
根據(jù)這個標準,我們可以推算出:
2020年第一周:2019.12.29-2020.1.4
所以,根據(jù)ISO 8601標準,2019年12月29日、2019年12月30日、2019年12月31日這兩天,其實不屬于2019年的最后一周,而是屬于2020年的第一周。
JDK針對ISO 8601提供的支持
根據(jù)ISO 8601中關于日歷星期和日表示法的定義,2019.12.29-2020.1.4是2020年的第一周。
我們希望輸入一個日期,然后程序告訴我們,根據(jù)ISO 8601中關于日歷日期的定義,這個日期到底屬于哪一年。
比如我輸入2019-12-20,他告訴我是2019;而我輸入2019-12-30的時候,他告訴我是2020。
為了提供這樣的數(shù)據(jù),Java 7引入了「YYYY」作為一個新的日期模式來作為標識。使用「YYYY」作為標識,再通過SimpleDateFormat就可以得到一個日期所屬的周屬于哪一年了。
所以,我們通過代碼可以驗證:
- 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
可見, 2019-12-30日因為屬于2020年的第一周,所以返回的年份是2020年。
而如果將「YYYY」改成「yyyy」的話,輸出結(jié)果就為:
- 2019
- 2019
- 2020
因為有這樣的情況,所以我們?nèi)粘i_發(fā)的時候,如果把y寫成了Y,那就可能導致日期輸出的結(jié)果不符合我們的預期。
當我們要表示日期的時候,一定要使用 yyyy-MM-dd 而不是 YYYY-MM-dd ,這兩者的返回結(jié)果大多數(shù)情況下都一樣,但是極端情況就會有問題了。
而這一個要求,在《阿里巴巴Java開發(fā)手冊》中也有類似的規(guī)定:
好啦,大家快去排查下你的代碼,有沒有'YYYY-MM-dd'這種形式的代碼吧,如果有的話,一定要改掉哦!~