求你了，别用 YYYY-MM-dd！

尤理有理2026-03-17 11:27

昨天下午看同事提交的代码，扫到这么一行，心里顿时咯噔一下：
new SimpleDateFormat("YYYY-MM-dd")

很多人敲代码顺手，或者被代码补全带偏，喜欢把 Y 和 M 全大写。但这在 Java 里，等于给系统埋了一颗隐蔽性极强的"跨年雷"，年底必炸。

为了预现场景，我构建了一段伪代码，故意把时间设置到了 2026 年 12 月 31 日：

java 复制代码

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

public class DateFormatTest {
    public static void main(String[] args) {
        // 故意构造一个跨年边缘的时间：2026年12月31日
        Calendar calendar = Calendar.getInstance();
        calendar.set(2026, Calendar.DECEMBER, 31);
        Date date = calendar.getTime();

        // 正确写法-小写 yyyy
        SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy-MM-dd");
        // 错误写法- 大写 YYYY
        SimpleDateFormat sdf2 = new SimpleDateFormat("YYYY-MM-dd");

        System.out.println("小写 yyyy: " + sdf1.format(date));
        System.out.println("大写 YYYY: " + sdf2.format(date));
    }
}

运行结果：

yaml 复制代码

12小写 yyyy: 2026-12-31
大写 YYYY: 2027-12-31  // 注意看，年份直接错乱了

发现没？原本是 2026 年的日期，用大写的 YYYY 格式化后，直接变成了 2027 年！

为什么会这样？

Java 的日期格式化标准里，大小写不同，意思完全不一样：

小写 yyyy：代表真实的日历年份，也就是你日历上看到的那一年。
大写 YYYY：代表的是 Week-Based-Year（基于周的年份）。简单来说，只要这一周跨年了------比如这周既有 2026 年底的几天，又包含了 2025 年的 1 月 1 日------那这周里的任何一天，年份都会被算作下一年。

这代码最恶心的地方就在这：平时测试根本发现不了，一切正常。只有到了每年最后那几天才会突然出问题，试想一下：用户的登录 Token 会因为「签发时间在未来」被集体拦截导致大面积掉线、扔进 MQ 的延迟消息也直接排到了下一年......细思恐极了朋友！

赶紧自查！

今天抽空打开 IDEA，按下 Ctrl + Shift + F（Mac 是 Cmd + Shift + F），全局搜一下 "YYYY（记得带上前引号）。如果真搜到了，赶紧改成 yyyy，算是提前排了个大雷。

顺手把这篇文章丢到团队群里，让大家都自查一下，能救一个是一个。