為什麼阿里巴巴要求日期格式化時必須有使用y表示年
在Java中進行日期處理大家一定都不陌生,我們經常會需要在程式碼中進行日期的轉換、日期的格式化等操作。
而一般我們進行日期格式化的時候都會使用SimpleDateFormat工具,之前我們有一篇文章介紹過SimpleDateFormat的執行緒安全問題(https://www.hollischuang.com/archives/3017),這一篇文章再來介紹一個和SimpleDateFormat有關,很容易被忽視,而一旦忽視可能導致大故障的問題。
SimpleDateFormat
SimpleDateFormat是Java提供的一個格式化和解析日期的工具類。它允許進行格式化(日期 -> 文字)、解析(文字 -> 日期)和規範化。SimpleDateFormat 使得可以選擇任何使用者定義的日期-時間格式的模式。
在Java中,可以使用SimpleDateFormat的format方法,將一個Date型別轉化成String型別,並且可以指定輸出格式。
// Date轉String Date data = new Date(); SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); String dataStr = sdf.format(data); System.out.println(dataStr);
以上程式碼,轉換的結果是:2018-11-25 13:00:00,日期和時間格式由”日期和時間模式”字串指定。如果你想要轉換成其他格式,只要指定不同的時間模式就行了。
在Java中,可以使用SimpleDateFormat的parse方法,將一個String型別轉化成Date型別。
// String轉Data System.out.println(sdf.parse(dataStr));
日期和時間模式表達方法
在使用SimpleDateFormat的時候,需要通過字母來描述時間元素,並組裝成想要的日期和時間模式。常用的時間元素和字母的對應表(JDK 1.8)如下:
模式字母通常是重複的,其數量確定其精確表示。如前面我們用過的"yyyy-MM-dd HH:mm:ss"。我們知道其中的y其實是year的縮寫,所以我們都知道使用y來表示年,預設情況下,我們都會使用y而不是Y,那麼這兩者之間有何區別呢?一旦用錯了會帶來什麼後果呢?
其實在規定中,y表示year,而Y表示Week Year!
什麼是Week Year
我們知道,不同的國家對於一週的開始和結束的定義是不同的。如在中國,我們把星期一作為一週的第一天,而在美國,他們把星期日作為一週的第一天。
同樣,如何定義哪一週是一年當中的第一週?這也是一個問題,有很多種方式。
比如下圖是2019年12月-2020年1月的一份日曆。
到底哪一週才算2020年的第一週呢?不同的地區和國家,甚至不同的人,都有不同的理解。
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
因為不同人對於日期和時間的表示方法有不同的理解,於是,大家就共同制定了了一個國際規範:ISO 8601 。
國際標準化組織的國際標準ISO 8601是日期和時間的表示方法,全稱為《資料儲存和交換形式·資訊交換·日期和時間的表示方法》。
在 ISO 8601中。對於一年的第一個日曆星期有以下四種等效說法:1,本年度第一個星期四所在的星期;2,1月4日所在的星期;3,本年度第一個至少有4天在同一星期內的星期;4,星期一在去年12月29日至今年1月4日以內的星期;
根據這個標準,我們可以推算出:
2020年第一週:2019.12.29-2020.1.4
所以,根據ISO 8601標準,2019年12月29日、2019年12月30日、2019年12月31日這兩天,其實不屬於2019年的最後一週,而是屬於2020年的第一週。
JDK針對ISO 8601提供的支援
根據ISO 8601中關於日曆星期和日表示法的定義,2019.12.29-2020.1.4是2020年的第一週。
我們希望輸入一個日期,然後程式告訴我們,根據ISO 8601中關於日曆日期的定義,這個日期到底屬於哪一年。
比如我輸入2019-12-20,他告訴我是2019;而我輸入2019-12-30的時候,他告訴我是2020。
為了提供這樣的資料,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"))); } }
輸出結果為:
2019
2020
2020
可見, 2019-12-30日因為屬於2020年的第一週,所以返回的年份是2020年。
而如果將「YYYY」改成「yyyy」的話,輸出結果就為:
2019
2019
2020
因為有這樣的情況,所以我們日常開發的時候,如果把y寫成了Y,那就可能導致日期輸出的結果不符合我們的預期。
當我們要表示日期的時候,一定要使用 yyyy-MM-dd 而不是 YYYY-MM-dd ,這兩者的返回結果大多數情況下都一樣,但是極端情況就會有問題了。
而這一個要求,在《阿里巴巴Java開發手冊》中也有類似的規定:
好啦,大家快去排查下你的程式碼,有沒有'YYYY-MM-dd'這種形式的程式碼吧,如果有的話,一定要改掉哦!~
到此這篇關於為什麼阿里巴巴要求日期格式化時必須有使用y表示年的文章就介紹到這了,更多相關阿里巴巴日期格式化y表示年內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們!