SimpleDateFormat(“YYYY-MM-dd“)格式化时间出现了bug?

最新推荐文章于 2026-06-16 15:05:15 发布

原创最新推荐文章于 2026-06-16 15:05:15 发布 · 517 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#bug

近期跨年的时候遇到了这样的时间格式化问题：

Calendar ca = Calendar.getInstance();
ca.set(Calendar.YEAR, 2025);
ca.set(Calendar.MONTH, Calendar.DECEMBER);
ca.set(Calendar.DAY_OF_MONTH, 25);

SimpleDateFormat sdf = new SimpleDateFormat("YYYY-MM-dd");
//输出：2025-12-25，没问题
System.out.println(sdf.format(ca.getTime()));

ca.set(Calendar.DAY_OF_MONTH, 30);
//输出：2026-12-30，有问题，我的预期是输出：2025-12-30
System.out.println(sdf.format(ca.getTime()));

这导致了什么问题？

我们系统的某个业务功能要按照年月日来生成文件夹和命名文件，由于使用了这种时间的格式化，导致了系统奇怪地出现了26年12月的文件夹，明明是在2025年啊；有些文件也被命名为了“20261231xxxx”。
年末3天的缓存数据，放入是成功的，但是获取就是获取不到，key奇怪地出现了20261231，明明期望的应该是20251231。
热点讨论功能前端要展示时间：刚刚、5分钟前、昨天 14:30、3天前、一年前。2025年12月29日这天的数据，前端居然永远展示“刚刚”。

问题点在哪里？

格式化年份的占位符使用了YYYY。
在SimpleDateFormat中，YYYY 是基于周（Week-Based-Year）的年份，而不是基于日期所在年的年份。

什么是 Week-Based-Year？

ISO-8601 标准：

一周从星期一开始
一年中的第一周，必须包含至少 4 天的新年

这就导致一个现象：有些 1 月初的日期，可能仍属于“上一年的最后一周”。

比如2025年12月的29、30、31日这三天，如果是Week-Based-Year，那么则归属是2026年，而不是2025年！

观察日历，得出一个简单的结论：新的一年所在的那一周，含有上一年的日期，YYYY方式的格式化，都会格式化错误。

什么时候才应该使用 YYYY？只有在做“基于周的统计”时才使用：

周报系统
财务周统计
周序号计算

怎么解决？

所以解决方案是：时间格式化时用yyyy-MM-dd✅，而不是YYYY-MM-dd❌。

@Test
public void test() {
    Calendar ca = Calendar.getInstance();
    ca.set(Calendar.YEAR, 2025);
    ca.set(Calendar.MONTH, Calendar.DECEMBER);
    ca.set(Calendar.DAY_OF_MONTH, 25);

    SimpleDateFormat sdf_wrong = new SimpleDateFormat("YYYY-MM-dd");
    SimpleDateFormat sdf_right = new SimpleDateFormat("yyyy-MM-dd");

    //输出：2025-12-25，没问题
    System.out.println(sdf_wrong.format(ca.getTime()));
    System.out.println(sdf_right.format(ca.getTime()));

    ca.set(Calendar.DAY_OF_MONTH, 30);
    System.out.println(sdf_wrong.format(ca.getTime())); //输出：2026-12-30，有问题，我的预期是输出：2025-12-30
    System.out.println(sdf_right.format(ca.getTime()));//输出：2025-12-30，没问题

    String format1 = DateTimeFormatter.ofPattern("YYYY-MM-dd").format(LocalDate.of(2025, 12, 31));
    System.out.println(format1);//输出：2025-12-31，没问题
    String format2 = DateTimeFormatter.ofPattern("yyyy-MM-dd").format(LocalDate.of(2025, 12, 31));
    System.out.println(format2);//输出：2025-12-31，没问题
}