DateTimeFormatter使用技巧与实例解析

本文深入解析了 Java 8+ 中线程安全、不可变的 DateTimeFormatter 核心用法，破除开发者对 SimpleDateFormat 的思维惯性，强调必须严格遵循 ISO 预定义常量（如 ISO_LOCAL_DATE）提升可靠性，精准掌握自定义 pattern 中大小写与数量的关键差异（如 y/Y、M/MM、HH/hh），明确区分 LocalDate/LocalDateTime/ZonedDateTime 的解析类型匹配原则以避免高频异常，并指出格式化前须主动处理时区转换——因为 DateTimeFormatter 本身不参与时区运算，只忠实执行字符串与时间对象间的双向转换，堪称高效、稳健日期处理的必修实践指南。

DateTimeFormatter 是 Java 8+ 中线程安全、不可变的日期格式化工具，直接用它做互转没问题，但必须避开 SimpleDateFormat 那套思维——它不共享状态，也不需要 synchronized，但对模式字符串敏感，错一个字符就抛 DateTimeParseException。

用预定义常量快速格式化常见场景

多数业务不需要手写 pattern，DateTimeFormatter 提供了几个开箱即用的静态常量，比如 ISO_LOCAL_DATE、ISO_LOCAL_DATE_TIME，它们严格遵循 ISO 8601，解析和格式化都可靠：

• LocalDate.parse("2024-05-20", DateTimeFormatter.ISO_LOCAL_DATE) 能成功
• LocalDateTime.parse("2024-05-20T14:30:45", DateTimeFormatter.ISO_LOCAL_DATE_TIME) 也能成功
• 但 "2024/05/20" 或 "2024-05-20 14:30" 这类非 ISO 格式，直接用预定义常量会抛 DateTimeParseException

这类常量适合 API 交互、日志时间戳等强调标准性的场景，省心且无兼容性风险。

自定义 pattern 时必须注意字母大小写和数量

pattern 字符不是随意写的：y 和 Y 含义不同，M 和 MM 解析行为也不同。常见踩坑点：

• yyyy-MM-dd：年份用小写 y（基于年份，非周年的），月份用大写 M（1–12），日期用小写 d（1–31）
• YYYY-MM-dd：大写 Y 表示“基于周的年”，在跨年周（如 2024-12-30 属于 2025 年第 1 周）时会出错，日常几乎不用
• HH:mm:ss 对应 24 小时制；hh:mm:ss a 才支持 AM/PM，且必须配 a，否则解析 "02:30:45 PM" 失败
• 单个 M 可解析 "2024-5-20"，但 MM 要求两位，"2024-5-20" 会报错

解析字符串时要匹配具体类型（LocalDate / LocalDateTime / ZonedDateTime）

不能拿一个字符串硬塞给所有类型解析。例如：

• "2024-05-20" 只含日期 → 用 LocalDate.parse(str, formatter)
• "2024-05-20 14:30:45" 含日期+时间但无时区 → 先用 LocalDateTime.parse(str, formatter)，再根据需要转成 ZonedDateTime
• "2024-05-20T14:30:45+08:00" 含偏移 → 必须用 ZonedDateTime.parse(str, formatter)，用 LocalDateTime 会丢时区信息或直接失败

类型不匹配是 DateTimeParseException 最常见来源，别指望自动推导。

格式化时注意时区和系统默认行为差异

DateTimeFormatter 本身不带时区，但你要格式化的对象可能带。比如：

• LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm")) 输出的是系统默认时区下的“本地时间”，但没显式时区标识
• ZonedDateTime.now(ZoneId.of("Asia/Shanghai")).format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSXXX")) 才能输出带 +08:00 的结果
• 如果只想要 UTC 时间，得先调用 withZoneSameInstant(ZoneOffset.UTC)，而不是靠 formatter “猜”

最容易被忽略的是：formatter 不负责时区转换，只负责把已有的时间对象按规则转成字符串。该换时区，得在 format 前做完。

今天关于《DateTimeFormatter使用技巧与实例解析》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！