ISO 8601 年/年月/年月日三级可选格式的严格解析与验证-java教程-PHP中文网

ISO 8601 年/年月/年月日三级可选格式的严格解析与验证

本文详解如何正确实现对 ISO 8601 格式中「仅年份（yyyy）」「年月（yyyy-MM）」「年月日（yyyy-MM-dd）」三种输入的全字段严格校验，解决 DateTimeFormatter.parseBest() 因类型回退导致非法值（如 1984-00、1984-13）意外通过的问题。

本文详解如何正确实现对 iso 8601 格式中「仅年份（yyyy）」「年月（yyyy-mm）」「年月日（yyyy-mm-dd）」三种输入的**全字段严格校验**，解决 `datetimeformatter.parsebest()` 因类型回退导致非法值（如 `1984-00`、`1984-13`）意外通过的问题。

Java 的 DateTimeFormatter.parseBest() 在传入多个 TemporalQuery（如 YearMonth::from, Year::from）时，会按顺序尝试解析：若前一个失败（如 YearMonth::from 无法处理 "1984-00"），则自动降级使用下一个（Year::from）。而 Year::from 仅需提取 uuuu 字段，完全忽略后续未匹配部分（如 -00），因此非法输入被静默接受——这违背了“格式完整且语义合法”的验证初衷。

根本问题在于：parseBest 不保证整个输入字符串被完全消费或所有字段被严格验证。要实现真正的严格校验，必须确保：

输入长度与预期格式严格对应；
所有解析出的字段均符合业务逻辑（如月份 ∈ [1,12]，日期不超当月天数）；
无残留未解析字符。

✅ 推荐方案：基于字符串长度分路解析 + 显式异常抛出
该方法简洁、可控、语义清晰，避免 DateTimeFormatterBuilder 中可选模式（如 [uuuu-MM]）带来的解析歧义和回退陷阱：

import java.time.*;
import java.time.format.DateTimeParseException;

public class IsoDateParser {

    public static Temporal parseIsoPartialDate(String input) {
        if (input == null || input.trim().isEmpty()) {
            throw new DateTimeParseException("Input string is null or empty", input, 0);
        }
        String value = input.trim();

        return switch (value.length()) {
            case 4 -> { // "yyyy"
                try {
                    Year year = Year.parse(value);
                    yield year;
                } catch (DateTimeParseException e) {
                    throw new DateTimeParseException(
                        "Invalid year format: must be 4-digit number (e.g., '2023')", value, 0);
                }
            }
            case 7 -> { // "yyyy-MM"
                try {
                    YearMonth yearMonth = YearMonth.parse(value);
                    // 显式校验月份有效性（虽 YearMonth.parse 已做，但增强可读性）
                    if (yearMonth.getMonthValue()  12) {
                        throw new DateTimeParseException(
                            "Month must be between 01 and 12", value, 5);
                    }
                    yield yearMonth;
                } catch (DateTimeParseException e) {
                    throw new DateTimeParseException(
                        "Invalid year-month format: must be 'yyyy-MM' with valid month", value, 0);
                }
            }
            case 10 -> { // "yyyy-MM-dd"
                try {
                    LocalDate date = LocalDate.parse(value);
                    yield date;
                } catch (DateTimeParseException e) {
                    throw new DateTimeParseException(
                        "Invalid date format: must be 'yyyy-MM-dd' with valid calendar date", value, 0);
                }
            }
            default -> throw new DateTimeParseException(
                "Unsupported length: expected 4 (yyyy), 7 (yyyy-MM), or 10 (yyyy-MM-dd) characters", 
                value, 0);
        };
    }

    // 使用示例
    public static void main(String[] args) {
        // ✅ 正确输入
        System.out.println(parseIsoPartialDate("2023"));           // Year[2023]
        System.out.println(parseIsoPartialDate("2023-06"));        // YearMonth[2023-06]
        System.out.println(parseIsoPartialDate("2023-06-15"));     // 2023-06-15

        // ❌ 严格拒绝非法输入
        // parseIsoPartialDate("2023-00"); // DateTimeParseException: Invalid year-month format...
        // parseIsoPartialDate("2023-13"); // DateTimeParseException: Invalid year-month format...
        // parseIsoPartialDate("2023-02-30"); // DateTimeParseException: Invalid date format...
    }
}

⚠️ 关键注意事项：

勿依赖 ResolverStyle.STRICT + 可选模式组合：[uuuu-MM] 或 uuuu[-MM] 在 STRICT 模式下仍允许部分字段缺失，且 parseBest 的类型回退机制会绕过字段级校验。
长度判断是第一道防线：ISO 8601 的 yyyy、yyyy-MM、yyyy-MM-dd 长度固定（4/7/10），利用此特性可快速分流并杜绝模糊匹配。
委托标准解析器：Year.parse()、YearMonth.parse()、LocalDate.parse() 内置了完备的范围检查（如 YearMonth.parse("2023-00") 直接抛 DateTimeParseException），无需手动校验。
明确异常信息：自定义错误消息能显著提升调试效率与 API 可用性。