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

结论先行

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

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

问题复现

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

1. import java.text.SimpleDateFormat;
2. import java.util.Date;
4. public class DateFormatDemo {
5.     public static void main(String[] args) {
6.         SimpleDateFormat sdf1 = new SimpleDateFormat("YYYY-MM-dd");
7.         SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy-MM-dd");
8.         
9.         Date date = new Date(121, 11, 26); // 2021年12月26日
10.         
11.         System.out.println(sdf1.format(date)); // 输出：2022-12-26
12.         System.out.println(sdf2.format(date)); // 输出：2021-12-26
13.     }
14. }

复制代码

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

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

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

以 2021年12月26日 为例：

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

2. yyyy 是「自然年份」

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

如何避免踩坑？

• 优先使用 yyyy
  除非明确需要基于周的年份计算，否则格式化日期时应使用 yyyy。
  
• 理解业务场景
  
  
  
  • 财务系统、周报统计等可能需要 YYYY（如按周生成报表）。
    
  • 普通日期场景（如订单时间、日志记录）应使用 yyyy。
    
  
  
• 注意 Locale 的影响
  
  
  
  • 不同地区的周起始日不同（如美国默认周日开始，欧洲多从周一开始）。
    
  • 可通过 SimpleDateFormat.setLocale() 或 DateTimeFormatter.withLocale() 指定区域。
    
  
  
• Java 8+ 的替代方案
  使用 DateTimeFormatter 时，yyyy 对应 Y 和 u 的行为更清晰：
  1. LocalDate date = LocalDate.of(2021, 12, 26);
  2. DateTimeFormatter formatter1 = DateTimeFormatter.ofPattern("YYYY-MM-dd");
  3. DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy-MM-dd");
  5. System.out.println(date.format(formatter1)); // 2022-12-26
  6. System.out.println(date.format(formatter2)); // 2021-12-26

  复制代码

总结

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

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

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！