本文详解如何用 DateTimeFormatter 正确处理毫秒（3位）和微秒（6位）精度混用的 ISO 格式时间字符串，避免解析异常，并推荐更简洁、健壮的默认解析方案。
本文详解如何用 `datetimeformatter` 正确处理毫秒（3位）和微秒（6位）精度混用的 iso 格式时间字符串，避免解析异常，并推荐更简洁、健壮的默认解析方案。
在 Java 8+ 的 java.time API 中，直接拼接多个带方括号的可选模式（如 "[yyyy-MM-dd'T'HH:mm:ss.SSS]" + "[yyyy-MM-dd'T'HH:mm:ss.SSSSSS]"）并不能实现“多模式匹配”——DateTimeFormatter.ofPattern() 不支持将多个独立可选块串联为“任一匹配”，而是会将其视为一个连续、严格的模式序列。因此，当输入 "2023-08-15T12:34:56.789123"（含6位微秒）时，解析器先成功匹配前段 [yyyy-MM-dd'T'HH:mm:ss.SSS]（消耗到 .123），但随后仍尝试继续匹配第二个 [yyyy-MM-dd'T'HH:mm:ss.SSSSSS] 的剩余部分（如 '789123'），导致索引 23 处出现未预期字符，抛出 DateTimeParseException。
✅ 最佳实践：优先使用默认 ISO 解析（零配置）
事实上，您提供的两个示例字符串：
-
"2021-01-30T23:45:00.123"（毫秒） -
"2023-08-15T12:34:56.789123"（微秒）
均严格符合 ISO 8601 扩展格式。而 LocalDateTime.parse(CharSequence) 的无参重载内置了智能分数秒解析能力：它能自动识别并容忍 1~9 位小数秒（即纳秒精度），无需任何自定义格式器：
public static void main(String[] args) {
String[] inputArray = {
"2021-01-30T23:45:00.123",
"2023-08-15T12:34:56.789123"
};
for (String input : inputArray) {
LocalDateTime parsed = LocalDateTime.parse(input); // ✅ 完全可靠
System.out.println(parsed);
}
System.out.println("No exception occurred!");
}
✅ 若必须显式使用 DateTimeFormatter：用嵌套可选语法
当业务强制要求显式格式器（如统一日志解析策略），应将分数秒部分整体设为可选，并分层嵌套精度：
DateTimeFormatter dateTimeFormats = DateTimeFormatter.ofPattern(
"yyyy-MM-dd'T'HH:mm:ss[.[SSSSSS][SSS]]"
);
说明：
-
.[SSSSSS][SSS]表示：先尝试匹配 6 位微秒（SSSSSS），失败则退回到 3 位毫秒（SSS）； - 外层方括号
[...]使整个.[SSSSSS][SSS]成为可选（即也兼容无小数秒的2023-01-01T12:00:00）； - 注意：
SSSSSS和SSS不能并列写成[SSS][SSSSSS]，因为解析器按顺序贪婪匹配，[SSS]总是先成功（截取前3位），导致后6位残留报错；必须用[SSSSSS][SSS]实现“长匹配优先”。
⚠️ 重要注意事项：
- 避免使用
DateTimeFormatterBuilder.appendOptional()拼接多个完整模式——它不解决“模式冲突”，仅用于构建复杂可选字段； -
DateTimeFormatter.ofPattern()不支持正则式或 OR 逻辑，所有方括号均为单次、局部可选，非全局多模式切换； - 若需解析带时区（如
Z或+08:00）的时间，应改用OffsetDateTime.parse()或ZonedDateTime.parse()，它们同样原生支持 ISO 变体。
总结：对标准 ISO 时间字符串，首选无参 parse() ——简洁、高效、健壮；仅在需强约束格式或非 ISO 场景时，才定制 DateTimeFormatter，并务必采用分层可选语法设计分数秒部分。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
