源码精品专栏

 


昨天你用的 YYYY-MM-dd 被 CTO 捶了吗?_java


摘要: 原创出处 http://www.iocoder.cn/IDEA/plugins/ 「芋道源码」欢迎转载,保留摘要,谢谢!

1. 概述

下班回家的路上,习惯性打开 群聊 ,不是为了解答问题,而是不想错过任何一个装 x 的机会。这不,就有胖友聊到一个经典的“神坑”:错误使用 YYYY-MM-dd 格式化时间,导致生产翻车。

昨天你用的 YYYY-MM-dd 被 CTO 捶了吗?_java_02带有马赛克的群聊2. 翻车示例

下面,艿艿带大家写一个翻车的 Java 示例代码:

import java.text.SimpleDateFormat;
import java.util.Calendar;

public class TestXXXXXXXXXXXXX {

    public static void main(String[] args) {
        // 创建 2020-12-31
        Calendar calendar = Calendar.getInstance();
        calendar.set(2020, Calendar.DECEMBER, 31);

        // 演示 YYYY-MM-dd 输出示例
        SimpleDateFormat dfYYYY = new SimpleDateFormat("YYYY-MM-dd");
        System.out.println("YYYY-MM-dd 输出:" + dfYYYY.format(calendar.getTime()));

        // 演示 yyyy-MM-dd 输出示例
        SimpleDateFormat dfyyyy = new SimpleDateFormat("yyyy-MM-dd");
        System.out.println("yyyy-MM-dd 输出:" + dfyyyy.format(calendar.getTime()));
    }

}

讲道理,正确输出的时间格式化结果应该为 "2020-12-31",但是使用 YYYY-MM-dd 却是 "2021-12-31"。如下图所示:

昨天你用的 YYYY-MM-dd 被 CTO 捶了吗?_java_03翻车啦3. 翻车原因

为什么使用 YYYY-MM-dd 格式化 "2020-12-31" 时间时,打印的结果是错误 的 "2021-12-31" 呢?

我们打开 https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#patterns 文档,看看 YYYY 的定义描述,就非常好理解背后的原因:

官方文档

翻译君:YYYY 使用的是 week-based-year,当天所在的周属于的年份,一周从周日开始,周六结束。只要本周跨年,那么这周就算入下一年。

关键在于 “只要本周跨年,那么这周就算入下一年 ” 这句话!什么意思呢,打开日历,安排的明明白白。

日历 - 2020~12

因为 "2021-01-01" 属于 2021 年,而 "2020-12-31" 与其处于同一周,所以被 YYYY 格式化时,输出的肯定是 2021 啦。不仅仅如此,这个问题,从 "2020-12-27" 开始就已经存在。

我们再来打开日历到 2021 年的 12 月来瞅瞅,康康还会不会存在翻车的情况。

昨天你用的 YYYY-MM-dd 被 CTO 捶了吗?_java_04日历 - 2021~12

答案当然是,翻车 !

未来不过是历史的一再重演。

4. 怎么避免

问题的解决,非常容易,只要将 YYYY-MM-dd 修改成 yyyy-MM-dd 即可。

但是,仅仅这样就足够了吗?良心 的艿艿,建议胖友一定要定义一个 DateUtil 工具类,并在其中将常用 的日期格式都提供好,禁止 在其它地方定义。

昨天你用的 YYYY-MM-dd 被 CTO 捶了吗?_java_05日历 - 2021~12

实际上,有良好 IDEA 使用习惯的胖友,绝对不会出现 YYYY 这样的问题,因为 IDEA 已经智能提醒 。

昨天你用的 YYYY-MM-dd 被 CTO 捶了吗?_java_06IDEA

一切 IDEA 警告,皆为错误,必须去解决。


End~继续抠脚。

我是艿艿,一个每天徘徊在煞笔 与牛啤 的死胖子。

昨天你用的 YYYY-MM-dd 被 CTO 捶了吗?_java_07