2019 年最后一天，在家里看著跨年晚會，享受著這一年最后一天的閑暇時光，女朋友在旁邊玩手機?？戳艘粫笏蝗粏栁乙恍┖芷婀值膯栴}。

[[312432]] 

圖片來自 Pexels

于是我拿過她的手機，看到了下面這一幕：

這是微信官方出的公眾號管理的 App，上面赫然寫著一篇文章的發(fā)文日期是 2020/12/29。

SimpleDateFormat

SimpleDateFormat 是 Java 提供的一個格式化和解析日期的工具類。它允許進行格式化(日期→文本)、解析(文本→日期)和規(guī)范化。

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)如下： 

模式字母通常是重復的，其數(shù)量確定其精確表示。如前面我們用過的"yyyy-MM-dd HH:mm:ss"。 

什么是 Week Year

我們知道，不同的國家對于一周的開始和結束的定義是不同的。如在中國，我們把星期一作為一周的第一天，而在美國，他們把星期日作為一周的第一天。

同樣，如何定義哪一周是一年當中的第一周?這也是一個問題，有很多種方式。

比如下圖是 2019 年 12 月-2020 年 1 月的一份日歷：

到底哪一周才算 2020 年的第一周呢?不同的地區(qū)和國家，甚至不同的人，都有不同的理解：

• 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

因為不同人對于日期和時間的表示方法有不同的理解，于是，大家就共同制定了了一個國際規(guī)范：ISO 8601 。

國際標準化組織的國際標準 ISO 8601 是日期和時間的表示方法，全稱為《數(shù)據(jù)存儲和交換形式·信息交換·日期和時間的表示方法》。

在 ISO 8601 中，對于一年的第一個日歷星期有以下四種等效說法：

• 本年度第一個星期四所在的星期。
• 1 月 4 日所在的星期。
• 本年度第一個至少有 4 天在同一星期內的星期。
• 星期一在去年 12 月 29 日至今年 1 月 4 日以內的星期。

根據(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"))); 
    } 
} 

輸出結果為：

2019 
2020 
2020 

可見， 2019-12-30 日因為屬于 2020 年的第一周，所以返回的年份是 2020 年。

而如果將「YYYY」改成「yyyy」的話，輸出結果就為：

2019 
2019 
2020 

因為有這樣的情況，所以我們日常開發(fā)的時候，如果把 y 寫成了 Y，那就可能導致日期輸出的結果不符合我們的預期。

當我們要表示日期的時候，一定要使用 yyyy-MM-dd 而不是 YYYY-MM-dd ，這兩者的返回結果大多數(shù)情況下都一樣，但是極端情況就會有問題了。

因為作者的 IDEA 中安裝了<阿里巴巴開發(fā)手冊的插件>，所以在代碼中使用「YYYY」的時候，IDEA 會彈出以下提示：

好啦，大家快去排查下你的代碼，有沒有'YYYY-MM-dd'這種形式的代碼吧，如果有的話，一定要改掉哦!~