前言在Java开发中日期格式化是一个高频场景但很多开发者都踩过这个坑用SimpleDateFormat格式化跨年日期时明明是2024年12月31日却显示成了2025年12月31日——这就是YYYY大写Y惹的祸这个问题的核心是Java中yyyy小写y和YYYY大写Y的本质区别以及ISO-8601周年制的特殊规则。本文将从问题复现出发深度剖析两者的区别揭秘周年制背后的玄机并给出多种可落地的规避方案帮你彻底避开这个坑。文章目录前言一、问题复现跨年日期显示错误的直观感受1.1 错误代码示例1.2 错误输出结果二、深度剖析yyyy vs YYYY的本质区别揭秘ISO-8601周年制2.1 核心区别日历年 vs 周年制2.2 关键玄机ISO-8601周年制的规则ISO-8601周年制的核心规则用具体例子理解规则三、什么时候应该用YYYY什么时候绝对不能用3.1 什么时候可以用YYYY3.2 什么时候绝对不能用YYYY四、多种规避方案彻底解决跨年日期显示错误4.1 方案一用小写的yyyy代替大写的YYYY最简单、最通用适合所有Java版本正确代码示例正确输出结果额外提醒SimpleDateFormat是线程不安全的4.2 方案二用Java 8的DateTimeFormatter推荐线程安全API清晰正确代码示例正确输出结果DateTimeFormatter的优势4.3 方案三用Joda-Time库适合Java 7及以下版本第一步引入Joda-Time依赖第二步正确代码示例正确输出结果4.4 方案四如果必须用YYYY确保理解周年制规则仅适用于按周统计场景按周统计的正确代码示例正确输出结果五、避坑指南这5个错误不要犯5.1 永远不要在显示普通日期的时候用YYYY5.2 优先用Java 8的DateTimeFormatter代替SimpleDateFormat5.3 用小写的yyyy不要用大写的YYYY5.4 测试跨年日期确保日期显示正确5.5 用代码审查工具检查日期格式字符串六、总结yyyy vs YYYY的核心区别与正确使用一、问题复现跨年日期显示错误的直观感受我们先通过一个可复现的Java代码示例直观感受这个问题1.1 错误代码示例importjava.text.SimpleDateFormat;importjava.util.Date;importjava.util.Calendar;publicclassDateFormatErrorDemo{publicstaticvoidmain(String[]args){// 注意这里用的是大写的YYYYSimpleDateFormatsdfnewSimpleDateFormat(YYYY-MM-dd);// 测试12024年12月30日周一Calendarcal1Calendar.getInstance();cal1.set(2024,Calendar.DECEMBER,30);Datedate1cal1.getTime();System.out.println(2024-12-30 格式化结果sdf.format(date1));// 测试22024年12月31日周二Calendarcal2Calendar.getInstance();cal2.set(2024,Calendar.DECEMBER,31);Datedate2cal2.getTime();System.out.println(2024-12-31 格式化结果sdf.format(date2));// 测试32025年1月1日周三Calendarcal3Calendar.getInstance();cal3.set(2025,Calendar.JANUARY,1);Datedate3cal3.getTime();System.out.println(2025-01-01 格式化结果sdf.format(date3));}}1.2 错误输出结果运行上面的代码你会看到出乎意料的输出2024-12-30 格式化结果2025-12-30 2024-12-31 格式化结果2025-12-31 2025-01-01 格式化结果2025-01-01问题来了2024年12月30日、31日明明是2024年的日期为什么格式化后变成了2025年这就是YYYY大写Y导致的跨年错误二、深度剖析yyyy vs YYYY的本质区别揭秘ISO-8601周年制要解决这个问题必须先搞懂yyyy小写y和YYYY大写Y的本质区别以及ISO-8601周年制的特殊规则。2.1 核心区别日历年 vs 周年制Java的SimpleDateFormat中y和Y是两个完全不同的概念符号英文全称中文含义本质定义y小写Year日历年我们常说的“公历年”从1月1日到12月31日年份固定不变Y大写Week Year周年制ISO-8601标准基于“周数”计算的年份一年从“第一周的周一”开始到“最后一周的周日”结束2.2 关键玄机ISO-8601周年制的规则YYYY大写Y的问题本质是ISO-8601周年制的特殊规则导致的。ISO-8601是国际标准化组织制定的日期和时间表示标准其中对“周年制”和“周数”有严格的定义ISO-8601周年制的核心规则一周的定义一周从周一开始到周日结束注意不是周日到周一一年的第一周必须满足以下两个条件之一包含该年的第一个星期四包含该年的1月4日换句话说一年的第一周必须包含该年的至少4天周年制的一年从第一周的周一开始到最后一周的周日结束跨年周的归属如果某一周跨越了两个日历年那么这一周的周年制年份取决于这一周的大部分天数属于哪一年或者说取决于这一周是否包含该年的第一个星期四。用具体例子理解规则我们用刚才的测试日期2024年12月30日-2025年1月1日来解释2024年12月30日周一2024年12月31日周二2025年1月1日周三2025年1月2日周四2025年的第一个星期四。根据ISO-8601的规则2024年12月30日周一到2025年1月5日周日这一周包含了2025年的第一个星期四1月2日因此这一周属于2025年的第一周所以这一周的所有日期包括2024年12月30日、31日用YYYY大写Y格式化时年份都会显示成2025年这就是为什么2024年12月30日、31日会显示成2025年的原因三、什么时候应该用YYYY什么时候绝对不能用3.1 什么时候可以用YYYYYYYY大写Y不是完全没用它只适用于按周统计的场景比如按周统计销量2025年第1周销量按周统计用户活跃度2025年第2周活跃用户数按周生成报表2025-W01表示2025年第1周。在这些场景下用YYYY大写Y是正确的因为我们确实需要按周年制来统计。3.2 什么时候绝对不能用YYYY在显示普通日期、存储日期、传递日期的场景下绝对不能用YYYY大写Y比如显示用户的生日1990-01-01显示订单的创建时间2024-12-31 12:00:00存储日期到数据库2024-12-31前后端传递日期2024-12-31。在这些场景下用YYYY大写Y会导致跨年日期显示错误是绝对错误的四、多种规避方案彻底解决跨年日期显示错误根据不同的Java版本和业务场景我们给出4种可落地的规避方案优先级从高到低4.1 方案一用小写的yyyy代替大写的YYYY最简单、最通用适合所有Java版本这是最简单、最直接、最通用的方案——只要把格式字符串中的YYYY大写Y改成yyyy小写y就能彻底解决问题正确代码示例importjava.text.SimpleDateFormat;importjava.util.Date;importjava.util.Calendar;publicclassDateFormatFixDemo1{publicstaticvoidmain(String[]args){// 注意这里用的是小写的yyyySimpleDateFormatsdfnewSimpleDateFormat(yyyy-MM-dd);// 测试12024年12月30日周一Calendarcal1Calendar.getInstance();cal1.set(2024,Calendar.DECEMBER,30);Datedate1cal1.getTime();System.out.println(2024-12-30 格式化结果sdf.format(date1));// 测试22024年12月31日周二Calendarcal2Calendar.getInstance();cal2.set(2024,Calendar.DECEMBER,31);Datedate2cal2.getTime();System.out.println(2024-12-31 格式化结果sdf.format(date2));// 测试32025年1月1日周三Calendarcal3Calendar.getInstance();cal3.set(2025,Calendar.JANUARY,1);Datedate3cal3.getTime();System.out.println(2025-01-01 格式化结果sdf.format(date3));}}正确输出结果2024-12-30 格式化结果2024-12-30 2024-12-31 格式化结果2024-12-31 2025-01-01 格式化结果2025-01-01完美所有日期都显示正确了额外提醒SimpleDateFormat是线程不安全的虽然这个方案能解决问题但要注意SimpleDateFormat不是线程安全的在多线程环境下比如Web应用的Controller中共享同一个SimpleDateFormat实例会导致日期格式化错误甚至抛出异常多线程环境下的正确用法每次使用时创建新的SimpleDateFormat实例性能稍差但安全用ThreadLocal存储SimpleDateFormat实例性能好安全优先用Java 8的DateTimeFormatter推荐见方案二。4.2 方案二用Java 8的DateTimeFormatter推荐线程安全API清晰如果你用的是Java 8及以上版本强烈推荐用DateTimeFormatter代替SimpleDateFormat——DateTimeFormatter是线程安全的API更清晰也避免了y和Y的混淆虽然DateTimeFormatter中也有y和Y的区别但API更规范。正确代码示例importjava.time.LocalDate;importjava.time.format.DateTimeFormatter;publicclassDateFormatFixDemo2{publicstaticvoidmain(String[]args){// 注意这里用的是小写的yyyyDateTimeFormatterformatterDateTimeFormatter.ofPattern(yyyy-MM-dd);// 测试12024年12月30日周一LocalDatedate1LocalDate.of(2024,12,30);System.out.println(2024-12-30 格式化结果date1.format(formatter));// 测试22024年12月31日周二LocalDatedate2LocalDate.of(2024,12,31);System.out.println(2024-12-31 格式化结果date2.format(formatter));// 测试32025年1月1日周三LocalDatedate3LocalDate.of(2025,1,1);System.out.println(2025-01-01 格式化结果date3.format(formatter));}}正确输出结果2024-12-30 格式化结果2024-12-30 2024-12-31 格式化结果2024-12-31 2025-01-01 格式化结果2025-01-01DateTimeFormatter的优势线程安全DateTimeFormatter是不可变类线程安全可以在多线程环境下共享同一个实例API清晰LocalDate、LocalTime、LocalDateTime的API更直观更容易理解避免混淆虽然DateTimeFormatter中也有y和Y的区别但API更规范文档更清晰功能强大支持更多的日期和时间操作比如加减天数、计算日期差等。4.3 方案三用Joda-Time库适合Java 7及以下版本如果你还在用Java 7及以下版本无法使用Java 8的DateTimeFormatter可以用Joda-Time库——Joda-Time是Java 8之前最流行的日期和时间处理库API安全、清晰也避免了y和Y的混淆。第一步引入Joda-Time依赖Maven项目的pom.xml中添加dependencygroupIdjoda-time/groupIdartifactIdjoda-time/artifactIdversion2.12.7/version!-- 最新稳定版本 --/dependency第二步正确代码示例importorg.joda.time.LocalDate;importorg.joda.time.format.DateTimeFormat;importorg.joda.time.format.DateTimeFormatter;publicclassDateFormatFixDemo3{publicstaticvoidmain(String[]args){// 注意这里用的是小写的yyyyDateTimeFormatterformatterDateTimeFormat.forPattern(yyyy-MM-dd);// 测试12024年12月30日周一LocalDatedate1newLocalDate(2024,12,30);System.out.println(2024-12-30 格式化结果date1.toString(formatter));// 测试22024年12月31日周二LocalDatedate2newLocalDate(2024,12,31);System.out.println(2024-12-31 格式化结果date2.toString(formatter));// 测试32025年1月1日周三LocalDatedate3newLocalDate(2025,1,1);System.out.println(2025-01-01 格式化结果date3.toString(formatter));}}正确输出结果2024-12-30 格式化结果2024-12-30 2024-12-31 格式化结果2024-12-31 2025-01-01 格式化结果2025-01-014.4 方案四如果必须用YYYY确保理解周年制规则仅适用于按周统计场景如果你确实需要按周统计必须用YYYY大写Y那么一定要完全理解ISO-8601周年制的规则避免在错误的场景下使用。按周统计的正确代码示例importjava.time.LocalDate;importjava.time.format.DateTimeFormatter;importjava.time.temporal.WeekFields;importjava.util.Locale;publicclassDateFormatWeekDemo{publicstaticvoidmain(String[]args){// 按周统计的场景用YYYY和w周数DateTimeFormatterformatterDateTimeFormatter.ofPattern(YYYY-Www);// 测试2024年12月30日属于2025年第1周LocalDatedateLocalDate.of(2024,12,30);System.out.println(2024-12-30 按周统计结果date.format(formatter));}}正确输出结果2024-12-30 按周统计结果2025-W01这个结果是正确的因为2024年12月30日确实属于2025年的第1周五、避坑指南这5个错误不要犯5.1 永远不要在显示普通日期的时候用YYYY显示用户生日、订单创建时间、存储日期到数据库、前后端传递日期等场景绝对不能用YYYY只有在按周统计的场景下才能用YYYY。5.2 优先用Java 8的DateTimeFormatter代替SimpleDateFormatSimpleDateFormat不是线程安全的在多线程环境下会出问题DateTimeFormatter是线程安全的API更清晰功能更强大优先推荐使用。5.3 用小写的yyyy不要用大写的YYYY除非你确实需要按周统计否则永远用小写的yyyy养成习惯写日期格式字符串时先写yyyy再写MM、dd。5.4 测试跨年日期确保日期显示正确每年的12月30日、31日1月1日、2日是跨年日期的高发期用单元测试覆盖这些日期确保日期显示正确比如测试2024-12-30、2024-12-31、2025-01-01、2025-01-02。5.5 用代码审查工具检查日期格式字符串可以用SonarQube、Checkstyle等代码审查工具检查代码中是否有使用YYYY的情况配置规则禁止在非按周统计的场景下使用YYYY。六、总结yyyy vs YYYY的核心区别与正确使用最后我们用一句话总结核心观点yyyy小写y是普通的日历年永远安全YYYY大写Y是ISO-8601周年制仅适用于按周统计的场景在显示普通日期时绝对不能用否则会导致跨年日期显示错误关键要点回顾核心区别yyyy日历年从1月1日到12月31日YYYY周年制基于周数计算从第一周的周一到最后一周的周日。ISO-8601规则一周从周一开始周日结束一年的第一周包含该年的第一个星期四跨年周的归属取决于是否包含该年的第一个星期四。规避方案方案一用小写的yyyy代替大写的YYYY最简单、最通用方案二用Java 8的DateTimeFormatter推荐线程安全方案三用Joda-Time库适合Java 7及以下方案四如果必须用YYYY确保理解周年制规则仅适用于按周统计。避坑指南永远不要在显示普通日期的时候用YYYY优先用Java 8的DateTimeFormatter测试跨年日期确保日期显示正确用代码审查工具检查日期格式字符串。永远记住日期格式化是一个高频但容易出错的场景一定要小心谨慎避免线上出问题
如何解决Java中`YYYY-MM-dd`导致的跨年日期显示错误？深度剖析yyyy vs YYYY的区别，揭秘ISO-8601周年制背后的玄机，并给出多种规避方案
前言在Java开发中日期格式化是一个高频场景但很多开发者都踩过这个坑用SimpleDateFormat格式化跨年日期时明明是2024年12月31日却显示成了2025年12月31日——这就是YYYY大写Y惹的祸这个问题的核心是Java中yyyy小写y和YYYY大写Y的本质区别以及ISO-8601周年制的特殊规则。本文将从问题复现出发深度剖析两者的区别揭秘周年制背后的玄机并给出多种可落地的规避方案帮你彻底避开这个坑。文章目录前言一、问题复现跨年日期显示错误的直观感受1.1 错误代码示例1.2 错误输出结果二、深度剖析yyyy vs YYYY的本质区别揭秘ISO-8601周年制2.1 核心区别日历年 vs 周年制2.2 关键玄机ISO-8601周年制的规则ISO-8601周年制的核心规则用具体例子理解规则三、什么时候应该用YYYY什么时候绝对不能用3.1 什么时候可以用YYYY3.2 什么时候绝对不能用YYYY四、多种规避方案彻底解决跨年日期显示错误4.1 方案一用小写的yyyy代替大写的YYYY最简单、最通用适合所有Java版本正确代码示例正确输出结果额外提醒SimpleDateFormat是线程不安全的4.2 方案二用Java 8的DateTimeFormatter推荐线程安全API清晰正确代码示例正确输出结果DateTimeFormatter的优势4.3 方案三用Joda-Time库适合Java 7及以下版本第一步引入Joda-Time依赖第二步正确代码示例正确输出结果4.4 方案四如果必须用YYYY确保理解周年制规则仅适用于按周统计场景按周统计的正确代码示例正确输出结果五、避坑指南这5个错误不要犯5.1 永远不要在显示普通日期的时候用YYYY5.2 优先用Java 8的DateTimeFormatter代替SimpleDateFormat5.3 用小写的yyyy不要用大写的YYYY5.4 测试跨年日期确保日期显示正确5.5 用代码审查工具检查日期格式字符串六、总结yyyy vs YYYY的核心区别与正确使用一、问题复现跨年日期显示错误的直观感受我们先通过一个可复现的Java代码示例直观感受这个问题1.1 错误代码示例importjava.text.SimpleDateFormat;importjava.util.Date;importjava.util.Calendar;publicclassDateFormatErrorDemo{publicstaticvoidmain(String[]args){// 注意这里用的是大写的YYYYSimpleDateFormatsdfnewSimpleDateFormat(YYYY-MM-dd);// 测试12024年12月30日周一Calendarcal1Calendar.getInstance();cal1.set(2024,Calendar.DECEMBER,30);Datedate1cal1.getTime();System.out.println(2024-12-30 格式化结果sdf.format(date1));// 测试22024年12月31日周二Calendarcal2Calendar.getInstance();cal2.set(2024,Calendar.DECEMBER,31);Datedate2cal2.getTime();System.out.println(2024-12-31 格式化结果sdf.format(date2));// 测试32025年1月1日周三Calendarcal3Calendar.getInstance();cal3.set(2025,Calendar.JANUARY,1);Datedate3cal3.getTime();System.out.println(2025-01-01 格式化结果sdf.format(date3));}}1.2 错误输出结果运行上面的代码你会看到出乎意料的输出2024-12-30 格式化结果2025-12-30 2024-12-31 格式化结果2025-12-31 2025-01-01 格式化结果2025-01-01问题来了2024年12月30日、31日明明是2024年的日期为什么格式化后变成了2025年这就是YYYY大写Y导致的跨年错误二、深度剖析yyyy vs YYYY的本质区别揭秘ISO-8601周年制要解决这个问题必须先搞懂yyyy小写y和YYYY大写Y的本质区别以及ISO-8601周年制的特殊规则。2.1 核心区别日历年 vs 周年制Java的SimpleDateFormat中y和Y是两个完全不同的概念符号英文全称中文含义本质定义y小写Year日历年我们常说的“公历年”从1月1日到12月31日年份固定不变Y大写Week Year周年制ISO-8601标准基于“周数”计算的年份一年从“第一周的周一”开始到“最后一周的周日”结束2.2 关键玄机ISO-8601周年制的规则YYYY大写Y的问题本质是ISO-8601周年制的特殊规则导致的。ISO-8601是国际标准化组织制定的日期和时间表示标准其中对“周年制”和“周数”有严格的定义ISO-8601周年制的核心规则一周的定义一周从周一开始到周日结束注意不是周日到周一一年的第一周必须满足以下两个条件之一包含该年的第一个星期四包含该年的1月4日换句话说一年的第一周必须包含该年的至少4天周年制的一年从第一周的周一开始到最后一周的周日结束跨年周的归属如果某一周跨越了两个日历年那么这一周的周年制年份取决于这一周的大部分天数属于哪一年或者说取决于这一周是否包含该年的第一个星期四。用具体例子理解规则我们用刚才的测试日期2024年12月30日-2025年1月1日来解释2024年12月30日周一2024年12月31日周二2025年1月1日周三2025年1月2日周四2025年的第一个星期四。根据ISO-8601的规则2024年12月30日周一到2025年1月5日周日这一周包含了2025年的第一个星期四1月2日因此这一周属于2025年的第一周所以这一周的所有日期包括2024年12月30日、31日用YYYY大写Y格式化时年份都会显示成2025年这就是为什么2024年12月30日、31日会显示成2025年的原因三、什么时候应该用YYYY什么时候绝对不能用3.1 什么时候可以用YYYYYYYY大写Y不是完全没用它只适用于按周统计的场景比如按周统计销量2025年第1周销量按周统计用户活跃度2025年第2周活跃用户数按周生成报表2025-W01表示2025年第1周。在这些场景下用YYYY大写Y是正确的因为我们确实需要按周年制来统计。3.2 什么时候绝对不能用YYYY在显示普通日期、存储日期、传递日期的场景下绝对不能用YYYY大写Y比如显示用户的生日1990-01-01显示订单的创建时间2024-12-31 12:00:00存储日期到数据库2024-12-31前后端传递日期2024-12-31。在这些场景下用YYYY大写Y会导致跨年日期显示错误是绝对错误的四、多种规避方案彻底解决跨年日期显示错误根据不同的Java版本和业务场景我们给出4种可落地的规避方案优先级从高到低4.1 方案一用小写的yyyy代替大写的YYYY最简单、最通用适合所有Java版本这是最简单、最直接、最通用的方案——只要把格式字符串中的YYYY大写Y改成yyyy小写y就能彻底解决问题正确代码示例importjava.text.SimpleDateFormat;importjava.util.Date;importjava.util.Calendar;publicclassDateFormatFixDemo1{publicstaticvoidmain(String[]args){// 注意这里用的是小写的yyyySimpleDateFormatsdfnewSimpleDateFormat(yyyy-MM-dd);// 测试12024年12月30日周一Calendarcal1Calendar.getInstance();cal1.set(2024,Calendar.DECEMBER,30);Datedate1cal1.getTime();System.out.println(2024-12-30 格式化结果sdf.format(date1));// 测试22024年12月31日周二Calendarcal2Calendar.getInstance();cal2.set(2024,Calendar.DECEMBER,31);Datedate2cal2.getTime();System.out.println(2024-12-31 格式化结果sdf.format(date2));// 测试32025年1月1日周三Calendarcal3Calendar.getInstance();cal3.set(2025,Calendar.JANUARY,1);Datedate3cal3.getTime();System.out.println(2025-01-01 格式化结果sdf.format(date3));}}正确输出结果2024-12-30 格式化结果2024-12-30 2024-12-31 格式化结果2024-12-31 2025-01-01 格式化结果2025-01-01完美所有日期都显示正确了额外提醒SimpleDateFormat是线程不安全的虽然这个方案能解决问题但要注意SimpleDateFormat不是线程安全的在多线程环境下比如Web应用的Controller中共享同一个SimpleDateFormat实例会导致日期格式化错误甚至抛出异常多线程环境下的正确用法每次使用时创建新的SimpleDateFormat实例性能稍差但安全用ThreadLocal存储SimpleDateFormat实例性能好安全优先用Java 8的DateTimeFormatter推荐见方案二。4.2 方案二用Java 8的DateTimeFormatter推荐线程安全API清晰如果你用的是Java 8及以上版本强烈推荐用DateTimeFormatter代替SimpleDateFormat——DateTimeFormatter是线程安全的API更清晰也避免了y和Y的混淆虽然DateTimeFormatter中也有y和Y的区别但API更规范。正确代码示例importjava.time.LocalDate;importjava.time.format.DateTimeFormatter;publicclassDateFormatFixDemo2{publicstaticvoidmain(String[]args){// 注意这里用的是小写的yyyyDateTimeFormatterformatterDateTimeFormatter.ofPattern(yyyy-MM-dd);// 测试12024年12月30日周一LocalDatedate1LocalDate.of(2024,12,30);System.out.println(2024-12-30 格式化结果date1.format(formatter));// 测试22024年12月31日周二LocalDatedate2LocalDate.of(2024,12,31);System.out.println(2024-12-31 格式化结果date2.format(formatter));// 测试32025年1月1日周三LocalDatedate3LocalDate.of(2025,1,1);System.out.println(2025-01-01 格式化结果date3.format(formatter));}}正确输出结果2024-12-30 格式化结果2024-12-30 2024-12-31 格式化结果2024-12-31 2025-01-01 格式化结果2025-01-01DateTimeFormatter的优势线程安全DateTimeFormatter是不可变类线程安全可以在多线程环境下共享同一个实例API清晰LocalDate、LocalTime、LocalDateTime的API更直观更容易理解避免混淆虽然DateTimeFormatter中也有y和Y的区别但API更规范文档更清晰功能强大支持更多的日期和时间操作比如加减天数、计算日期差等。4.3 方案三用Joda-Time库适合Java 7及以下版本如果你还在用Java 7及以下版本无法使用Java 8的DateTimeFormatter可以用Joda-Time库——Joda-Time是Java 8之前最流行的日期和时间处理库API安全、清晰也避免了y和Y的混淆。第一步引入Joda-Time依赖Maven项目的pom.xml中添加dependencygroupIdjoda-time/groupIdartifactIdjoda-time/artifactIdversion2.12.7/version!-- 最新稳定版本 --/dependency第二步正确代码示例importorg.joda.time.LocalDate;importorg.joda.time.format.DateTimeFormat;importorg.joda.time.format.DateTimeFormatter;publicclassDateFormatFixDemo3{publicstaticvoidmain(String[]args){// 注意这里用的是小写的yyyyDateTimeFormatterformatterDateTimeFormat.forPattern(yyyy-MM-dd);// 测试12024年12月30日周一LocalDatedate1newLocalDate(2024,12,30);System.out.println(2024-12-30 格式化结果date1.toString(formatter));// 测试22024年12月31日周二LocalDatedate2newLocalDate(2024,12,31);System.out.println(2024-12-31 格式化结果date2.toString(formatter));// 测试32025年1月1日周三LocalDatedate3newLocalDate(2025,1,1);System.out.println(2025-01-01 格式化结果date3.toString(formatter));}}正确输出结果2024-12-30 格式化结果2024-12-30 2024-12-31 格式化结果2024-12-31 2025-01-01 格式化结果2025-01-014.4 方案四如果必须用YYYY确保理解周年制规则仅适用于按周统计场景如果你确实需要按周统计必须用YYYY大写Y那么一定要完全理解ISO-8601周年制的规则避免在错误的场景下使用。按周统计的正确代码示例importjava.time.LocalDate;importjava.time.format.DateTimeFormatter;importjava.time.temporal.WeekFields;importjava.util.Locale;publicclassDateFormatWeekDemo{publicstaticvoidmain(String[]args){// 按周统计的场景用YYYY和w周数DateTimeFormatterformatterDateTimeFormatter.ofPattern(YYYY-Www);// 测试2024年12月30日属于2025年第1周LocalDatedateLocalDate.of(2024,12,30);System.out.println(2024-12-30 按周统计结果date.format(formatter));}}正确输出结果2024-12-30 按周统计结果2025-W01这个结果是正确的因为2024年12月30日确实属于2025年的第1周五、避坑指南这5个错误不要犯5.1 永远不要在显示普通日期的时候用YYYY显示用户生日、订单创建时间、存储日期到数据库、前后端传递日期等场景绝对不能用YYYY只有在按周统计的场景下才能用YYYY。5.2 优先用Java 8的DateTimeFormatter代替SimpleDateFormatSimpleDateFormat不是线程安全的在多线程环境下会出问题DateTimeFormatter是线程安全的API更清晰功能更强大优先推荐使用。5.3 用小写的yyyy不要用大写的YYYY除非你确实需要按周统计否则永远用小写的yyyy养成习惯写日期格式字符串时先写yyyy再写MM、dd。5.4 测试跨年日期确保日期显示正确每年的12月30日、31日1月1日、2日是跨年日期的高发期用单元测试覆盖这些日期确保日期显示正确比如测试2024-12-30、2024-12-31、2025-01-01、2025-01-02。5.5 用代码审查工具检查日期格式字符串可以用SonarQube、Checkstyle等代码审查工具检查代码中是否有使用YYYY的情况配置规则禁止在非按周统计的场景下使用YYYY。六、总结yyyy vs YYYY的核心区别与正确使用最后我们用一句话总结核心观点yyyy小写y是普通的日历年永远安全YYYY大写Y是ISO-8601周年制仅适用于按周统计的场景在显示普通日期时绝对不能用否则会导致跨年日期显示错误关键要点回顾核心区别yyyy日历年从1月1日到12月31日YYYY周年制基于周数计算从第一周的周一到最后一周的周日。ISO-8601规则一周从周一开始周日结束一年的第一周包含该年的第一个星期四跨年周的归属取决于是否包含该年的第一个星期四。规避方案方案一用小写的yyyy代替大写的YYYY最简单、最通用方案二用Java 8的DateTimeFormatter推荐线程安全方案三用Joda-Time库适合Java 7及以下方案四如果必须用YYYY确保理解周年制规则仅适用于按周统计。避坑指南永远不要在显示普通日期的时候用YYYY优先用Java 8的DateTimeFormatter测试跨年日期确保日期显示正确用代码审查工具检查日期格式字符串。永远记住日期格式化是一个高频但容易出错的场景一定要小心谨慎避免线上出问题
