为什么阿里巴巴要求日期格式化时必须有使用y表示年，而不能用Y？

灰太狼 2022-11-27 12:14 90阅读 0赞

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

![format_png][]

模式字母通常是重复的，其数量确定其精确表示。如前面我们用过的"yyyy-MM-dd HH:mm:ss"。我们知道其中的y其实是year的缩写，所以我们都知道使用y来表示年，默认情况下，我们都会使用y而不是Y，那么这两者之间有何区别呢？一旦用错了会带来什么后果呢？

其实在规定中，y表示year，而Y表示Week Year！

### **什么是Week Year** ###

我们知道，不同的国家对于一周的开始和结束的定义是不同的。如在中国，我们把星期一作为一周的第一天，而在美国，他们把星期日作为一周的第一天。

同样，如何定义哪一周是一年当中的第一周？这也是一个问题，有很多种方式。

比如下图是2019年12月-2020年1月的一份日历。

![format_png 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开发手册》中也有类似的规定：

![format_png 2][]

好啦，大家快去排查下你的代码，有没有'YYYY-MM-dd'这种形式的代码吧，如果有的话，一定要改掉哦！~

[format_png]: /images/20221124/4af007d8d9354084aaef7257e8528507.png
[format_png 1]: /images/20221124/3059b78f8a1d4a0e934ad249e4d73c2f.png
[format_png 2]: /images/20221124/2f278cc9600745cd92cbb386e9bb663f.png