Java获取当前时间并格式化输出：DateTimeFormatter与SimpleDateFormat

在Java应用程序开发中，获取当前系统时间并转换成指定格式的文本（例如 2026-03-31 15:30:00）是一项基础且高频的操作。完成这项任务有两种截然不同的工具链：一种是Java 8及以上版本推荐使用的 java.time.LocalDateTime 配合 DateTimeFormatter，另一种是历史遗留的 java.util.Date 配合 java.text.SimpleDateFormat。两者的核心差异在于线程安全模型、API设计理念以及底层架构。

获取并格式化时间的执行步骤

无论是现代API还是旧版类库，获取当前时间并将其格式化输出给用户或日志，都遵循标准的处理管道：初始化系统当前时间对象、构建具有特定模式串的格式化器，最后由格式化器或时间对象执行格式化方法生成目标字符串。

图 1：Java中时间获取与文本格式化的标准处理流

现代推荐方案：DateTimeFormatter（Java 8+）

自Java 8引入 java.time 包（JSR-310规范）以来，DateTimeFormatter 已经成为处理时间文本转化的行业标准。它是不可变类（Immutable），完全具备线程安全特性，适合在类中作为静态常量长期复用，而不需要在每次格式化时重新实例化。

完整使用示例

package com.example.time;

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class ModernTimeFormatExample {
    // 线程安全，推荐作为常量共享复用
    private static final DateTimeFormatter FORMATTER = 
            DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    public static void main(String[] args) {
        // 1. 获取当前系统默认时区的时间
        LocalDateTime currentDateTime = LocalDateTime.now();

        // 2. 执行格式化操作（两种写法等价）
        String output1 = currentDateTime.format(FORMATTER);
        String output2 = FORMATTER.format(currentDateTime);

        // 3. 打印结果
        System.out.println("标准格式化输出: " + output1);
        System.out.println("等价格式化输出: " + output2);
    }
}

运行输出结果示例：

标准格式化输出: 2026-03-31 15:42:19
等价格式化输出: 2026-03-31 15:42:19

在这段代码中，LocalDateTime.now() 会根据操作系统时钟和当前系统默认时区捕获年月日时分秒。DateTimeFormatter.ofPattern() 会把模式串解析为格式化组件。调用 currentDateTime.format(...) 或 FORMATTER.format(...) 都会得到完全相同的纯文本输出。

传统遗留方案：SimpleDateFormat（Java 1.0 - 7）

在Java 8之前，开发者通常借助 java.util.Date 与 java.text.SimpleDateFormat。这种方式依然广泛存在于维护老系统或处理老旧SDK接口的场景中。

完整使用示例

package com.example.time;

import java.text.SimpleDateFormat;
import java.util.Date;

public class LegacyTimeFormatExample {
    public static void main(String[] args) {
        // 1. 获取当前系统时间的时间戳封装对象
        Date currentDate = new Date();

        // 2. 构造指定模式的格式化器
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");

        // 3. 转换输出
        String output = sdf.format(currentDate);

        // 4. 打印结果
        System.out.println("旧版格式化输出: " + output);
    }
}

运行输出结果示例：

旧版格式化输出: 2026-03-31 15:42:19

关键陷阱：SimpleDateFormat的线程安全问题与原理

为什么现代系统极力避免在并发环境下共用 SimpleDateFormat？关键在于其内部维护的状态变量。

在 SimpleDateFormat 的继承树中，基类 DateFormat 内部维护了一个共享的 protected Calendar calendar 对象。当调用 format(Date date) 时，代码首先会执行 calendar.setTime(date)，然后再从 calendar 中读取各个时间字段。如果在多线程共享单例的场景下，线程A刚把自己的时间赋值给 calendar，CPU发生上下文切换，线程B紧接着用自己的时间重写了 calendar，此时线程A恢复运行并取值，就会读到线程B的数据甚至不合法的脏数据，导致时间输出错乱或抛出 NumberFormatException。

图 2：SimpleDateFormat与DateTimeFormatter底层多线程运行状态对比

常见格式化占位符规则及易混淆点

在编写模式串（Pattern）时，大小写的混淆会导致严重的时间换算错误。以下是Java时间格式化中最关键的字符映射规范：

图 3：时间格式化关键占位符匹配规范

特别需要防范的是 yyyy 与 YYYY 的混淆：YYYY 遵循的是“基于周的年份”（Week-based Year）。在ISO-8601规范下，如果某年的最后几天所处的完整一周跨入了次年，且该周在新年的天数更多，YYYY 会直接算作次年。例如在2024年12月29日使用 YYYY-MM-dd 格式化，输出结果可能会变成 2025-12-29。因此，业务开发中格式化公历年份，必须严格使用小写 yyyy。

特性对比与选型维度

在技术选型和项目重构时，我们可以从线程安全性、所属版本、类型支持等维度直观审视两者的差异：

全景总结与架构决策路线

针对Java获取当前时间并输出格式化文本的任务，开发决策路径十分明确：

图 4：Java时间格式化组件架构选型与安全实践全景图

只要项目运行在Java 8及以上环境，永远优先使用 LocalDateTime 配合静态常量化的 DateTimeFormatter。这不仅能消除并发隐患，而且代码表达力更强。只有在对接必须接收 java.util.Date 的陈旧接口时，才需要考虑通过 Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant()) 进行过渡转换，从而彻底从架构层面杜绝时间处理相关的并发风险。