推荐用 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 时类型和字符串结构必须严丝合缝 —— 这些细节不写单元测试很容易漏。










