使用DateTimeFormatterBuilder可选模式解析LocalDate时抛出DateTimeParseException

你遇到的核心问题很明确：当解析yyyyMM格式的字符串时，LocalDate要求必须包含年、月、日三个完整字段，而你的初始实现没有为缺失的日字段设置默认值，所以直接抛出了解析异常。年份格式能正常工作可能是巧合，其实如果只解析yyyy的话，同样会缺月和日字段，只是可能你的代码没覆盖到这个场景的测试。

先把你截断的初始代码补全（推测是这样的）：

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;
import java.time.temporal.ChronoField;

public class DateParser {
    private static final DateTimeFormatter FORMATTER = new DateTimeFormatterBuilder()
            .appendPattern("yyyy")
            .optionalStart()
            .appendPattern("MM")
            .optionalEnd()
            .optionalStart()
            .appendPattern("dd")
            .optionalEnd()
            .toFormatter();

    public static LocalDate parse(String input) {
        return LocalDate.parse(input, FORMATTER);
    }
}

这种写法的问题很直观：当输入是202405时，解析器只能拿到年和月的信息，没有日的字段值，LocalDate无法构造完整日期，自然会抛出DateTimeParseException。

正确的实现方式 #

我们需要借助DateTimeFormatterBuilder的parseDefaulting方法，为缺失的字段设置合理的默认值。因为LocalDate必须具备年、月、日三个字段，所以：

• 当只有年份时，默认月为1月，日为1日
• 当有年月时，默认日为当月第一天

完整的可运行代码如下：

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;
import java.time.temporal.ChronoField;

public class FlexibleLocalDateParser {
    // 构建支持三种格式的解析器，优先匹配最长格式避免误判
    private static final DateTimeFormatter FLEXIBLE_FORMATTER = new DateTimeFormatterBuilder()
            .appendPattern("yyyyMMdd")
            .optionalStart()
            .appendPattern("yyyyMM")
            .optionalEnd()
            .optionalStart()
            .appendPattern("yyyy")
            .optionalEnd()
            // 为缺失的日设置默认值：当月第一天
            .parseDefaulting(ChronoField.DAY_OF_MONTH, 1)
            // 为缺失的月设置默认值：1月
            .parseDefaulting(ChronoField.MONTH_OF_YEAR, 1)
            .toFormatter();

    public static LocalDate parseDate(String dateStr) {
        return LocalDate.parse(dateStr, FLEXIBLE_FORMATTER);
    }

    public static void main(String[] args) {
        // 测试三种输入格式
        System.out.println(parseDate("2024"));      // 输出: 2024-01-01
        System.out.println(parseDate("202405"));    // 输出: 2024-05-01
        System.out.println(parseDate("20240520"));  // 输出: 2024-05-20
    }
}

关键细节说明 #

1. 格式匹配顺序：一定要先放最长的格式（yyyyMMdd），再放较短的。解析器会按顺序尝试匹配，避免把20240520这类完整日期误判为yyyyMM格式。
2. 默认值自定义：如果你的业务需要年份默认是当年最后一天，可以把DAY_OF_MONTH的默认值改为ChronoField.DAY_OF_MONTH.range().getMaximum()，不过通常默认当月第一天更符合常规需求。
3. 异常处理：如果需要处理非法输入（比如202413这种无效月份），可以在parseDate方法里捕获DateTimeParseException，做自定义的错误提示或兜底处理。

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