扎心了!新年遇到的第一個Bug!
2019 年最后一天,在家里看著跨年晚會,享受著這一年最后一天的閑暇時光,女朋友在旁邊玩手機。看了一會之后她突然問我一些很奇怪的問題。
圖片來自 Pexels
于是我拿過她的手機,看到了下面這一幕:
這是微信官方出的公眾號管理的 App,上面赫然寫著一篇文章的發文日期是 2020/12/29。
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"。
什么是 Week Year
我們知道,不同的國家對于一周的開始和結束的定義是不同的。如在中國,我們把星期一作為一周的第一天,而在美國,他們把星期日作為一周的第一天。
同樣,如何定義哪一周是一年當中的第一周?這也是一個問題,有很多種方式。
比如下圖是 2019 年 12 月-2020 年 1 月的一份日歷:
到底哪一周才算 2020 年的第一周呢?不同的地區和國家,甚至不同的人,都有不同的理解:
- 1 月 1 日是周三,到下周三(1 月 8 日),這 7 天算作這一年的第一周。
- 因為周日(周一)才是一周的第一天,所以,要從 2020 年的第一個周日(周一)開始往后推 7 天才算這一年的第一周。
- 因為 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 月 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 ,這兩者的返回結果大多數情況下都一樣,但是極端情況就會有問題了。
因為作者的 IDEA 中安裝了<阿里巴巴開發手冊的插件>,所以在代碼中使用「YYYY」的時候,IDEA 會彈出以下提示:
好啦,大家快去排查下你的代碼,有沒有'YYYY-MM-dd'這種形式的代碼吧,如果有的話,一定要改掉哦!~