Java 实例 – 格式化时间（SimpleDateFormat）（手把手讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在 Java 开发中，时间格式化是一个高频需求。无论是记录日志、生成报告，还是与用户交互，开发者常常需要将日期和时间以特定格式展示或解析。SimpleDateFormat 是 Java 标准库中处理此类任务的核心工具。本文将通过实例详解其用法、常见问题及优化方案，帮助读者从基础到进阶掌握这一工具。

一、什么是 SimpleDateFormat？

SimpleDateFormat 是 Java 中用于格式化（将日期对象转换为字符串）和解析（将字符串转换为日期对象）的类。它基于预定义的格式模式，例如 yyyy-MM-dd 或 HH:mm:ss，可以灵活适配不同场景的需求。

形象比喻：
可以将 SimpleDateFormat 想象为一位“翻译官”。它能将日期对象（如 Date 或 Calendar）翻译成人类可读的字符串，也能将符合规则的字符串翻译回日期对象。例如：

• 格式化：把 Sat Jun 15 14:30:00 GMT+08:00 2024 转换为 2024-06-15 14:30。
• 解析：把 2024-06-15 转换为对应的日期对象。

二、基础用法：格式化日期

1. 格式化模式符号

SimpleDateFormat 的核心是格式模式字符串。以下是常用的模式符号：

注意：模式符号区分大小写。例如 Y 不是年份符号，而 E 表示星期几（如 "Monday"）。

2. 格式化代码示例

以下代码演示如何将当前时间格式化为 yyyy-MM-dd HH:mm:ss 格式：

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

public class DateFormatExample {
    public static void main(String[] args) {
        // 创建 SimpleDateFormat 实例，指定模式
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        
        // 获取当前时间
        Date now = new Date();
        
        // 格式化时间
        String formattedTime = formatter.format(now);
        
        System.out.println("当前时间：" + formattedTime);
    }
}

输出示例：
当前时间：2024-06-15 14:30:45

三、进阶用法：解析字符串为日期

除了格式化，SimpleDateFormat 还能解析字符串为 Date 对象。但需注意：

1. 模式必须与字符串格式严格匹配，否则抛出 ParseException。
2. 时区问题：若字符串中包含时区信息（如 GMT+08:00），需在模式中添加 Z 或 XXX 符号。

示例：解析日期字符串

public class DateParseExample {
    public static void main(String[] args) {
        String dateStr = "2024-06-15 14:30:00";
        SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        
        try {
            Date parsedDate = formatter.parse(dateStr);
            System.out.println("解析后的日期对象：" + parsedDate);
        } catch (ParseException e) {
            e.printStackTrace();
        }
    }
}

输出示例：
解析后的日期对象：Sat Jun 15 14:30:00 GMT+08:00 2024

四、常见问题与解决方案

1. 线程不安全问题

SimpleDateFormat 不是线程安全的。在多线程环境下，多个线程共享同一个实例可能导致数据错乱。例如：

// 错误示例（线程不安全）
public class UnsafeDateFormat {
    private static final SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd");
    
    public static void main(String[] args) {
        for (int i = 0; i < 10; i++) {
            new Thread(() -> {
                try {
                    Thread.sleep(100);
                    System.out.println(formatter.format(new Date()));
                } catch (InterruptedException e) {
                    e.printStackTrace();
                }
            }).start();
        }
    }
}

问题：多个线程同时调用 format() 方法可能导致输出结果混乱，例如：
2024-06-15 14:30:00
2024-06-15 14:30:01
2024-06-15 14:30:02 → 但实际时间可能不同

解决方案：

• 每次创建新实例：适用于低并发场景，但可能影响性能。

  // 安全但低效
  String formatted = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
  

• 使用 ThreadLocal 缓存实例：

  // 线程安全的 ThreadLocal 实现
  private static final ThreadLocal<SimpleDateFormat> formatterHolder = 
      new ThreadLocal<SimpleDateFormat>() {
          @Override
          protected SimpleDateFormat initialValue() {
              return new SimpleDateFormat("yyyy-MM-dd");
          }
      };
  
  public static String format(Date date) {
      return formatterHolder.get().format(date);
  }
  

• 迁移到 Java 8+ 的 DateTimeFormatter：推荐使用 java.time.format.DateTimeFormatter，它是线程安全的。

2. 时区问题

默认情况下，SimpleDateFormat 使用 JVM 的默认时区（如 Asia/Shanghai）。若需指定其他时区，可通过 TimeZone 设置：

SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm z");
formatter.setTimeZone(TimeZone.getTimeZone("GMT")); // 设置为格林威治时间
Date date = formatter.parse("2024-06-15 14:30 GMT"); 
System.out.println(date); // 输出：Sat Jun 15 22:30:00 GMT+08:00 2024（北京时间）

五、替代方案：Java 8+ 的 DateTimeFormatter

Java 8 引入了 java.time 包（JSR-310），其中 DateTimeFormatter 是 SimpleDateFormat 的现代化替代。其优点包括：

• 线程安全：无需额外处理即可安全使用。
• 更直观的 API：例如 DateTimeFormatter.ISO_LOCAL_DATE 提供标准格式。
• 更好的时区支持：基于 ZoneId 类，更清晰。

示例：使用 DateTimeFormatter

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

public class NewDateFormatExample {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        String formatted = now.format(formatter);
        System.out.println(formatted); // 输出：2024-06-15 14:30:45
    }
}

六、总结

本文通过实例演示了 SimpleDateFormat 在格式化和解析日期中的核心用法，同时探讨了线程安全、时区等进阶问题。对于新项目，建议优先采用 DateTimeFormatter 以获得更好的性能和安全性。

关键词回顾：

• Java 实例 – 格式化时间（SimpleDateFormat） 是 Java 开发中不可或缺的技能，掌握其基础用法和潜在风险，能显著提升代码的健壮性。
• 通过本文的示例和解决方案，读者可以快速解决时间格式化问题，并为后续学习 java.time 包打下基础。

希望本文能帮助开发者在实际项目中高效处理时间格式化需求！