Java日期格式化中的“YYYY”陷阱：为什么跨年周会让你的年份突然+1？.md

结论先行

在Java中使用 YYYY-MM-dd 格式化日期时，若日期所在的周跨年，年份可能会被错误计算为下一年（如2021年12月26日显示为2022年）。而使用 yyyy-MM-dd 会始终返回正确的年份。问题的根源是 YYYY 和 yyyy 对年份的定义不同：YYYY 是「基于周的年份」，而 yyyy 是「自然年份」。

文章持续更新，可以微信搜一搜「 半个脑袋儿 」第一时间阅读

---

问题复现

尝试用以下代码格式化 2021-12-26：

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

public class DateFormatDemo {
    public static void main(String[] args) {
        SimpleDateFormat sdf1 = new SimpleDateFormat("YYYY-MM-dd");
        SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy-MM-dd");

        Date date = new Date(121, 11, 26); // 2021年12月26日

        System.out.println(sdf1.format(date)); // 输出：2022-12-26
        System.out.println(sdf2.format(date)); // 输出：2021-12-26
    }
}

结果差异明显，YYYY 的年份跳到了2022年。

---

原因解析

1. YYYY 是「基于周的年份」

• 定义：YYYY 遵循 ISO 8601 标准，表示「日期所在周所属的年份」。
• 周的计算规则：
  • 默认一周从 周日开始，到 周六结束（可通过 Locale 调整，如某些地区从周一开始）。
  • 若某周跨年（即该周包含新年的第一天），则这一周会被归属到新年所在的年份。

以 2021年12月26日 为例：

• 该周为 2021年12月26日（周日）至2022年1月1日（周六）。
• 由于这一周的大部分天数（4天）属于2022年，因此 YYYY 会将其归属到2022年。

2. yyyy 是「自然年份」

• 定义：yyyy 直接表示日期所在的自然年份，与周无关。
• 无论日期是否跨周或跨月，始终返回实际年份。

---

如何避免踩坑？

1. 优先使用 yyyy
   
   除非明确需要基于周的年份计算，否则格式化日期时应使用 yyyy。

2. 理解业务场景

   • 财务系统、周报统计等可能需要 YYYY（如按周生成报表）。
   • 普通日期场景（如订单时间、日志记录）应使用 yyyy。

3. 注意 Locale 的影响

   • 不同地区的周起始日不同（如美国默认周日开始，欧洲多从周一开始）。
   • 可通过 SimpleDateFormat.setLocale() 或 DateTimeFormatter.withLocale() 指定区域。

4. Java 8+ 的替代方案
   
   使用 DateTimeFormatter 时，yyyy 对应 Y 和 u 的行为更清晰：

   LocalDate date = LocalDate.of(2021, 12, 26);
   DateTimeFormatter formatter1 = DateTimeFormatter.ofPattern("YYYY-MM-dd");
   DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy-MM-dd");
   
   System.out.println(date.format(formatter1)); // 2022-12-26
   System.out.println(date.format(formatter2)); // 2021-12-26
   

---

总结

• YYYY 与 yyyy 的区别：基于周的年份 vs 自然年份。
• 根本原因：跨年周的归属规则导致 YYYY 的年份偏移。
• 最佳实践：若无特殊需求，始终使用 yyyy-MM-dd 格式化日期。

一个小小的格式字符差异，可能导致跨年时的严重逻辑错误。切记：日期格式化无小事！