求你了,别用 YYYY-MM-dd!

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

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

昨天下午看同事提交的代码,扫到这么一行,心里顿时咯噔一下:

new SimpleDateFormat("YYYY-MM-dd")

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

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

import 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));
 }
}

运行结果:

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

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

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

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐