本文详解如何使用 DateTimeFormatterBuilder 实现对多种时区偏移格式（如 +01:00、+0100、+01、Z）的灵活解析，同时确保格式化输出仅采用标准 ISO 8601 偏移格式（如 +01:00），避免重复或冗余偏移字符串。
本文详解如何使用 `datetimeformatterbuilder` 实现对多种时区偏移格式（如 `+01:00`、`+0100`、`+01`、`z`）的**灵活解析**，同时确保**格式化输出仅采用标准 iso 8601 偏移格式（如 `+01:00`）**，避免重复或冗余偏移字符串。
在从 Joda-Time 迁移到 java.time 的过程中，一个常见陷阱是误用 optionalStart() / optionalEnd() 组合来处理多种偏移格式——这会导致格式化时将所有可选偏移模式“叠加输出”，例如生成 2023-02-08T09:30:00.000+01:00+0100+01 这类非法字符串。根本原因在于：optionalStart().appendOffset(...).optionalEnd() 并非定义“互斥的多种输入格式”，而是声明“该偏移部分可有可无”，且多个此类块会全部参与格式化渲染，而非按需择一。
✅ 正确做法是：解析与格式化职责分离
- 解析阶段：使用 appendOptional(DateTimeFormatter) 为每种可能的输入偏移格式注册独立的可选解析器；
- 格式化阶段：仅通过一个明确指定的、非可选的 .appendOffset("+HH:MM", "Z") 来统一控制输出格式。
以下是推荐的构建方式：
DateTimeFormatter dateTimeFormatter = new DateTimeFormatterBuilder()
// 必选基础：ISO 本地日期时间（不含偏移）
.append(DateTimeFormatter.ISO_LOCAL_DATE_TIME)
// 可选毫秒：仅当输入含 .SSS 时解析，不影响输出
.appendOptional(DateTimeFormatter.ofPattern(".SSS"))
// 可选偏移格式 1：+HH:MM（如 +01:00）
.appendOptional(DateTimeFormatter.ofPattern("+HH:MM"))
// 可选偏移格式 2：+HHMM（如 +0100）
.appendOptional(DateTimeFormatter.ofPattern("+HHMM"))
// 可选偏移格式 3：+HH（如 +01）
.appendOptional(DateTimeFormatter.ofPattern("+HH"))
// 可选偏移格式 4：Z（即 UTC）
.appendOptional(DateTimeFormatter.ofPattern("X")) // 注意：用 'X' 解析 Z/+0、+01 等简写，更健壮
// ✅ 关键：唯一且强制的输出偏移格式（仅用于 format，不影响 parse）
.appendOffset("+HH:MM", "Z")
.toFormatter();? 为什么用 appendOptional(...) 而非 optionalStart()？
appendOptional(f) 表示“尝试用格式器 f 解析一段文本，若失败则跳过，不报错”，各格式器彼此独立、互不干扰；而 optionalStart()...optionalEnd() 是语法块级可选，多个块在格式化时会全部尝试渲染，导致偏移重复。立即学习“Java免费学习笔记（深入）”；
? 重要注意事项：
- appendOffset("+HH:MM", "Z") 中的 "Z" 是占位符，表示当偏移为 +00:00 时输出字母 Z（符合 ISO 8601），它仅影响格式化结果，不影响解析逻辑；
- 解析时推荐优先使用 DateTimeFormatter.ofPattern("X") 或 "XX"/"XXX" 处理简写偏移（如 Z, +0, +01, +0100），比硬编码 +HH 更鲁棒；
- 若需支持大小写不敏感解析（如 t 替代 T），应在构建后调用 .parseCaseInsensitive()；
- 最终格式化时，dateTimeFormatter.format(zonedDateTime) 将严格输出 +HH:MM 或 Z，绝不会出现多偏移拼接。
✅ 验证效果（输出恒为标准格式）：
ZonedDateTime zdt = ZonedDateTime.of(2023, 2, 8, 9, 30, 0, 0, ZoneId.of("Europe/Paris"));
System.out.println(dateTimeFormatter.format(zdt));
// → "2023-02-08T09:30:00+01:00"总结：迁移 Joda-Time 的 withOffsetParsed() 行为，核心在于理解 java.time 格式器的“解析路径多样性”与“输出格式确定性”必须解耦。通过 appendOptional 构建宽泛解析能力，再以单一 appendOffset 锁定规范输出，即可无缝兼容历史数据并产出合规 ISO 字符串。
