推荐用 datetimeformatter 而非 simpledateformat，它线程安全、不可变、支持 iso 与自定义模式，需通过 ofpattern、iso 常量或 oflocalizeddatetime 等静态工厂创建，不可 new；format/parse 需类型匹配，时区字符串须用 zoneddatetime/offsetdatetime 解析，应 static final 复用。
Java 中时间格式化推荐用 DateTimeFormatter，而不是过时的 SimpleDateFormat。它线程安全、不可变、支持 ISO 和自定义模式，且与 LocalDateTime / ZonedDateTime 等现代时间类配合紧密。
怎么创建 DateTimeFormatter 实例
不能直接 new，必须通过静态工厂方法构建。常见方式有三类：
-
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")：最常用，支持自定义模式（注意大小写敏感，MM是月，mm是分） -
DateTimeFormatter.ISO_LOCAL_DATE_TIME：内置常量，对应2024-05-20T14:30:45格式，无需手动拼字符串 -
DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM)：按系统区域设置自动适配，比如中文环境输出 “2024年5月20日 下午2:30”
错误做法：new DateTimeFormatter(...) 会编译失败；DateTimeFormatter.getInstance() 不存在 —— 这是 SimpleDateFormat 的旧习惯，别套用。
format() 和 parse() 必须匹配类型
DateTimeFormatter 本身不绑定具体时间类型，但调用 format() 或 parse() 时，传入对象必须和格式器语义一致。例如：
立即学习“Java免费学习笔记（深入）”；
LocalDateTime now = LocalDateTime.now();
String s = DateTimeFormatter.ofPattern("yyyy-MM-dd").format(now); // ✅ 可以，忽略时分秒
// String s2 = DateTimeFormatter.ofPattern("HH:mm").format(now); // ❌ 警告：模式只含时间，但传了含日期的对象，逻辑上不匹配
反向解析更严格：
- 用
yyyy-MM-dd格式器去parse("2024-05-20")→ 返回LocalDate - 用同一格式器去
parse("2024-05-20 14:30")→ 抛DateTimeParseException，因为多出的时间部分无法被识别 - 想解析带时间的字符串，必须用包含时间字段的 pattern，如
yyyy-MM-dd HH:mm，且返回的是LocalDateTime
时区处理容易漏掉 ZonedDateTime / OffsetDateTime
如果原始时间含时区（比如 "2024-05-20T14:30:45+08:00"），别用 LocalDateTime.parse()，否则会丢时区信息并静默截断。
- 正确做法：用
ZonedDateTime.parse(str, formatter)或OffsetDateTime.parse(str, formatter) - 对应格式器需显式包含时区符号：如
ofPattern("yyyy-MM-dd'T'HH:mm:ss.SSSXXX")（XXX解析+08:00）或ISO_OFFSET_DATE_TIME - 若用
LocalDateTime.parse()强行解析带时区的字符串，会抛异常；若字符串恰好没时区字段，又会丢失上下文 —— 这是线上时差 bug 的高发点
性能与复用建议
DateTimeFormatter 是不可变对象，线程安全，应作为 static final 复用，而不是每次格式化都新建：
public class TimeUtils {
public static final DateTimeFormatter FULL_FMT = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSS");
public static String formatNow() {
return FULL_FMT.format(LocalDateTime.now());
}
}
频繁创建 formatter 会导致不必要的对象分配；而用 DateTimeFormatterBuilder 动态拼接 pattern（比如根据参数切换格式）虽可行，但通常没必要 —— 预定义几个常用常量更清晰、更快。
真正复杂的地方在于：pattern 字母含义易混淆（M月/m分/S毫秒/s秒）、时区符号写法多（X/XX/XXX 对应不同位数）、以及 parse 时类型和字符串结构必须严丝合缝 —— 这些细节不写单元测试很容易漏。
