YYYY日期格式化坑点解析

背景

今天在生产环境发现一个问题，给第三方推送的接口的时间参数跨了一年，导致对方查不到数据，首先定位了一下报文的代码，使用的new Date（）并且进行了格式化，按说不会出现相差一年的情况。

分析

该系统一直运行稳定，最近并没有进行更新，上周的日期还是正确的，但是本周就不行了，遂将该处代码进行单元测试。

 @Test(description = "测试日期格式换")
    public void testDate() {
        System.out.println(DateUtil.format(new Date(), "YYYY-MM-dd"));
    }

运行结果：

2022-12-28

===============================================
Default Suite
Total tests run: 1, Passes: 1, Failures: 0, Skips: 0
===============================================

嗯，问题确实复现了，后来查资料发现，由于格式化中使用大写的YYYY表示年份，导致了日期格式化的差异，如果换成小写的yyyy，就不会有问题。

那小写的yyyy和大写YYYY有什么不同呢，

y则是我们正常使用的年，而Y是week-based-year，即如果当前这周如果是跨年的话，则年度归属属于下一年
所以，这就是问题的原因，无用了YYYY，平时看起来没有什么问题，但是遇到跨年问题的话，就会出现严重的BUG，笔者今天就是遇到这样的情况。

talk is cheap, show me the code，我们也来也写个单元测试一探究竟吧

    public void formatDate(LocalDate dateTime, DateTimeFormatter formatter) {
        String dateTimeStr = dateTime.format(formatter);
        System.out.println("格式化前:" + dateTime);
        System.out.println("格式化后:" + dateTimeStr);
        System.out.println();
    }

    @Test(description = "测试日期格式化")
    public void dateFormatTest() {
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("YYYY-MM-dd");
        System.out.println("格式：YYYY-MM-dd");
        formatDate(LocalDate.now(), formatter);
        formatDate(LocalDate.of(2021, 12, 24), formatter);
        DateTimeFormatter formatterCopy = DateTimeFormatter.ofPattern("yyyy-MM-dd");
        System.out.println("格式：yyyy-MM-dd");
        formatDate(LocalDate.now(), formatterCopy);
        formatDate(LocalDate.of(2021, 12, 24), formatterCopy);
    }

运行结果：

格式：YYYY-MM-dd
格式化前:2021-12-28
格式化后:2022-12-28

格式化前:2021-12-24
格式化后:2021-12-24

格式：yyyy-MM-dd
格式化前:2021-12-28
格式化后:2021-12-28

格式化前:2021-12-24
格式化后:2021-12-24


===============================================
Default Suite
Total tests run: 1, Passes: 1, Failures: 0, Skips: 0
===============================================

很显然，上述的运行结果已经很明显了，这就是为什么之前系统都没有问题，而从这周开始出现了跨年的问题，因为这周六是2022年的元旦，所以使用YYYY格式化的话，就是将年度更改为2022年。

解决

当然，解决的方法很简单，我们只需要将格式化汇总的YYYY更改为yyyy即可。

扩展

问题是解决，当时我们可以进一步深挖一下这种大小写的问题，毕竟日期格式化这种形式用的还是挺多的。

DD和dd的区别

日期中的天一般标识day of month,所以这儿使用小写的dd即可，而大写的DD则表示 day of year，表示当前年度的天数，代码如下：

 @Test(description = "DD和dd的区别")
    public void diffDDdd() {
        System.out.println("使用DD格式化");
        System.out.println(DateUtil.format(new Date(), "yyyy-MM-DD"));
        System.out.println("使用dd格式化");
        System.out.println(DateUtil.format(new Date(), "yyyy-MM-dd"));
    }

运行结果：

使用DD格式化
2021-12-362
使用dd格式化
2021-12-28

===============================================
Default Suite
Total tests run: 1, Passes: 1, Failures: 0, Skips: 0
===============================================

当然了，像HH和hh，MM和mm，SSS和ss都有有区别的，这边提供一张格式明细说明，可参考

思考

很不起眼的一个问题，但是只有掉坑里了才会引起重视，受教了！[抱拳]