DateTimeFormatter的核心作用是格式化时间对象为字符串及解析字符串为时间对象，是Java 8后线程安全的唯一推荐方案，替代了不安全的SimpleDateFormat。
DateTimeFormatter 的核心作用就两个：**把 LocalDate、LocalDateTime 等时间对象转成字符串（格式化）**，以及**把符合规则的字符串还原成时间对象（解析）**。它不是装饰用的工具类，而是 Java 8 之后处理时间 ↔ 字符串转换的**唯一推荐入口**——替代了线程不安全又难维护的 SimpleDateFormat。
为什么必须用 DateTimeFormatter 而不是 SimpleDateFormat？
这不是“升级可选”，而是实际工程中的硬性要求：
-
SimpleDateFormat是可变对象，多线程共用一个实例时，parse()或format()极易因内部状态混乱抛出java.lang.NumberFormatException或返回错误时间（比如把 "2025-12-30" 解析成 1970 年） -
DateTimeFormatter是不可变（immutable）且线程安全的，定义一次可全局静态复用，无同步开销 - 错误提示更精准：例如用
yyyy-MM-dd去解析"2025/12/30"，会明确报错Text '2025/12/30' could not be parsed at index 4，直接定位到斜杠位置
三种创建方式怎么选？
别一上来就写 ofPattern —— 先看是否已有现成方案：
-
ISO 标准格式（最常用）：直接用预定义常量，零配置、无需记忆模式字母
LocalDateTime.parse("2025-12-30T08:54:12", DateTimeFormatter.ISO_LOCAL_DATE_TIME) -
本地化风格（如中文星期、月份）：用
ofLocalizedDateTime+Locale，避免手写 “年/月/日”DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM).withLocale(Locale.SIMPLIFIED_CHINESE) -
自定义格式（如日志、API 返回）：必须用
ofPattern，注意大小写敏感：MM是月，mm是分；HH是 24 小时制，hh是 12 小时制DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss")
解析字符串时最容易踩的坑
看似简单，但 80% 的 DateTimeParseException 都源于这几点：
-
模式与字符串不严格匹配：比如模式是
"yyyy-MM-dd"，但字符串是"2025-12-30 "（末尾有空格），会直接失败 —— 解析前建议先trim() -
忽略 Locale 导致中文解析失败：用
ofPattern("yyyy年MM月dd日")解析"2025年12月30日"时，若未显式传入Locale.SIMPLIFIED_CHINESE，在某些 JVM 默认语言环境下可能识别不了“年/月/日” -
类型错配：拿
LocalDateTime.parse(...)去解析只有日期的字符串（如"2025-12-30"），会报错；应改用LocalDate.parse(...)+DateTimeFormatter.ISO_LOCAL_DATE
LocalDateTime now = LocalDateTime.now();
// ✅ 正确：静态复用，线程安全
static final DateTimeFormatter LOG_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS");
String logTime = now.format(LOG_FORMATTER); // "2025-12-30 08:54:12.345"
LocalDateTime parsed = LocalDateTime.parse("2025-12-30 08:54:12.345", LOG_FORMATTER);
真正麻烦的从来不是写对一行 ofPattern，而是在跨系统、跨语言、跨时区场景下，确保格式器能稳定扛住各种输入变体——所以别省那几行 trim() 和 withLocale()。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
