Java DateTimeFormatter处理含自定义文本的日期格式为何报错？

DateTimeFormatter比SimpleDateFormat更严格，它要求模式对应的字段足够构建目标日期对象：如果要解析成LocalDate（包含年月日），必须提供足够的字段；如果只需要年+月/年+周，应该选择对应类型的日期对象（如YearMonth），而非强行解析为完整日期。

1. 解析月格式（如2023M10） #

方案一：直接解析为YearMonth（推荐） #

如果只需要年和月信息，直接解析为YearMonth类即可，模式yyyy'M'MM完全可用：

DateTimeFormatter monthFormatter = DateTimeFormatter.ofPattern("yyyy'M'MM");
YearMonth yearMonth = YearMonth.parse("2023M10", monthFormatter);
// 若需转为LocalDate，补充日信息即可（比如取当月第一天）
LocalDate date = yearMonth.atDay(1);

方案二：强制解析为LocalDate #

如果必须得到LocalDate，需要显式指定缺失的日字段默认值：

DateTimeFormatter dateFormatter = new DateTimeFormatterBuilder()
        .appendPattern("yyyy'M'MM")
        .parseDefaulting(ChronoField.DAY_OF_MONTH, 1) // 默认补当月第一天
        .toFormatter();
LocalDate date = LocalDate.parse("2023M10", dateFormatter);

2. 解析周格式（如2023W10） #

JDK标准库没有直接的YearWeek类，可通过两种方式处理：

方案一：解析为LocalDate，补全周内默认日 #

注意SimpleDateFormat默认以周日为一周起始，而DateTimeFormatter默认以周一为起始，需显式对齐规则：

// 匹配SimpleDateFormat的周规则（周日为一周第一天）
WeekFields usWeekFields = WeekFields.of(Locale.US);
DateTimeFormatter weekFormatter = new DateTimeFormatterBuilder()
        .appendPattern("yyyy'W'ww")
        .parseDefaulting(usWeekFields.dayOfWeek(), 1) // 默认补周日
        .toFormatter()
        .withWeekFields(usWeekFields);
LocalDate date = LocalDate.parse("2023W10", weekFormatter);

方案二：使用ThreeTen-Extra库的YearWeek #

如果允许引入第三方库，ThreeTen-Extra提供的YearWeek类更贴合需求：

DateTimeFormatter weekFormatter = DateTimeFormatter.ofPattern("yyyy'W'ww");
YearWeek yearWeek = YearWeek.parse("2023W10", weekFormatter);
// 转为LocalDate，比如取周内周一
LocalDate date = yearWeek.atDay(DayOfWeek.MONDAY);

关键差异总结 #

SimpleDateFormat会自动补全缺失的日期字段（如月缺日补1、周缺日补周起始日），而DateTimeFormatter默认不允许缺失必要字段，必须显式指定默认值或选择匹配的日期对象类型。

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