Java中解析日期时出现Unable to obtain LocalDate from TemporalAccessor异常的原因

问题重现 #

代码片段：

final String pattern = "MM/dd/YYYY";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
LocalDate localDate = LocalDate.parse(date, formatter);

解析字符串 String date = "05/29/2003" 时抛出异常：

Caused by: java.time.DateTimeException: Unable to obtain LocalDate from TemporalAccessor: {WeekBasedYear[WeekFields[SUNDAY,1]]=2023, DayOfMonth=29, MonthOfYear=5},ISO of type java.time.format.Parsed

核心原因 #

异常根源是日期格式模式中的 YYYY：

• YYYY 代表基于周的年份（Week-based Year），它的规则是：一年的第一周必须包含该年的指定锚点日期（比如部分地区以周日为一周起始，要求第一周包含1月1日；或国际标准以周一为起始，要求第一周包含1月4日/第一个周四），这会导致周基年与常规公历年在年初、年末时段可能相差1年。
• 当用YYYY解析常规公历年字符串时，解析器会将年份值识别为周基年，再结合月、日信息尝试生成LocalDate时，会出现「周基年+指定月日」无法对应到有效公历年日期的情况，进而抛出无法获取LocalDate的异常。

修复方案 #

将格式模式中的 YYYY 替换为代表公历年的 yyyy，修改后的代码：

final String pattern = "MM/dd/yyyy";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
LocalDate localDate = LocalDate.parse(date, formatter);

内容的提问来源于stack exchange，提问作者kris82pl