在Java中时间格式化怎么做_JavaDateTimeFormatter使用解析

推荐用 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：内置常量，对应 2025-05-20T14:30:45 格式，无需手动拼字符串
• DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM)：按系统区域设置自动适配，比如中文环境输出 “2025年5月20日 下午2:30”

错误做法：new DateTimeFormatter(...) 会编译失败；DateTimeFormatter.getInstance() 不存在 —— 这是 SimpleDateFormat 的旧习惯，别套用。

format() 和 parse() 必须匹配类型

DateTimeFormatter 本身不绑定具体时间类型，但调用 format() 或 parse() 时，传入对象必须和格式器语义一致。例如：

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("2025-05-20") → 返回 LocalDate
• 用同一格式器去 parse("2025-05-20 14:30") → 抛 DateTimeParseException，因为多出的时间部分无法被识别
• 想解析带时间的字符串，必须用包含时间字段的 pattern，如 yyyy-MM-dd HH:mm，且返回的是 LocalDateTime

时区处理容易漏掉 ZonedDateTime / OffsetDateTime

如果原始时间含时区（比如 "2025-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 时类型和字符串结构必须严丝合缝 —— 这些细节不写单元测试很

容易漏。