Java案例如何格式化日期？

wen java案例 2026-06-11 10

Java案例：如何优雅地格式化日期？从SimpleDateFormat到DateTimeFormatter的实战指南

📖 目录导读

为什么Java日期格式化这么重要？
基础篇：SimpleDateFormat的使用与陷阱
进阶篇：Java 8 DateTimeFormatter深度解析
实战案例：国际化的日期格式处理
常见问题Q&A（含代码对比）
性能与最佳实践总结

为什么Java日期格式化这么重要？

在开发中，日期格式化几乎是每个Java项目都会遇到的场景，无论是日志输出、API响应、数据库存储还是前端展示，开发人员都需要对日期值进行标准化处理，错误的日期格式可能导致解析异常、数据错乱甚至系统崩溃。

Java案例如何格式化日期？

核心问题：Java中的Date、Calendar以及新推出的LocalDateTime系列类，都有各自的格式化方案，但开发者经常混淆它们之间的差异，旧的SimpleDateFormat不是线程安全的，而新的DateTimeFormatter是线程安全的,但在旧项目中直接替换可能引发兼容性问题。

基础篇：SimpleDateFormat的使用与陷阱

1 基本用法

import java.text.SimpleDateFormat;
import java.util.Date;
public class OldFormatExample {
    public static void main(String[] args) {
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String formattedDate = sdf.format(new Date());
        System.out.println(formattedDate); // 输出：2025-03-21 14:30:00
    }
}

2 线程安全陷阱（高频面试题）

SimpleDateFormat不是线程安全的，当多个线程共享同一个实例时，format()或parse()方法会导致内部可变状态冲突，抛出NumberFormatException或返回错误结果。

错误示例：

// ❌ 多个线程会互相干扰
public static final SimpleDateFormat SDF = new SimpleDateFormat("yyyy-MM-dd");

正确做法：

使用ThreadLocal包装（不推荐,代码复杂）
每次使用时新建实例（轻微性能损失）
直接使用Java 8的DateTimeFormatter（推荐方案）

进阶篇：Java 8 DateTimeFormatter深度解析

1 为什么推荐Java 8版本？

从Java 8开始，引入了java.time包（基于Joda-Time的设计理念），其中DateTimeFormatter是不可变且线程安全的,并且提供了丰富的预定义格式器。

2 核心API示例

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class NewFormatExample {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();
        // 预定义格式器
        DateTimeFormatter formatter1 = DateTimeFormatter.ISO_LOCAL_DATE_TIME;
        System.out.println(now.format(formatter1)); // 2025-03-21T14:30:00
        // 自定义格式
        DateTimeFormatter formatter2 = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH:mm:ss");
        System.out.println(now.format(formatter2)); // 2025年03月21日 14:30:00
        // 解析字符串
        String dateStr = "2025-03-21 14:30:00";
        DateTimeFormatter parser = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        LocalDateTime parsedDate = LocalDateTime.parse(dateStr, parser);
        System.out.println(parsedDate); // 2025-03-21T14:30
    }
}

3 格式化模式字母表（重点记忆）

字母	含义	示例（2025-03-21）
yyyy	四位年份	2025
yy	两位年份	25
MM	月份（补零）	03
MMM	月份缩写（英文）	Mar
dd	日（补零）	21
HH	24小时制	14
hh	12小时制	02
mm	分钟	30
ss	秒	00

实战案例：国际化的日期格式处理

假设我们需要开发一个支持多语言的电商系统,不同国家用户看到的不同日期格式：

需求：

美国用户：MM/dd/yyyy（如03/21/2025）
中国用户：yyyy-MM-dd（如2025-03-21）
德国用户：dd.MM.yyyy（如21.03.2025）

代码实现（使用Locale）：

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.util.Locale;
public class InternationalFormat {
    public static void main(String[] args) {
        LocalDate date = LocalDate.now(); // 2025-03-21
        DateTimeFormatter usFormatter = DateTimeFormatter.ofPattern("MM/dd/yyyy", Locale.US);
        DateTimeFormatter cnFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd", Locale.CHINA);
        DateTimeFormatter deFormatter = DateTimeFormatter.ofPattern("dd.MM.yyyy", Locale.GERMANY);
        System.out.println("US: " + date.format(usFormatter)); // 03/21/2025
        System.out.println("CN: " + date.format(cnFormatter)); // 2025-03-21
        System.out.println("DE: " + date.format(deFormatter)); // 21.03.2025
    }
}

注意：只有涉及到月份/星期英文名称时才需要传入Locale参数,纯数字格式无需指定。

常见问题Q&A（含代码对比）

Q1：项目中既有Date又有LocalDateTime，如何统一格式化？

A：需要将Date先转为Instant，再转为LocalDateTime。

Date oldDate = new Date();
LocalDateTime localDateTime = oldDate.toInstant()
      .atZone(ZoneId.systemDefault())
      .toLocalDateTime();
String formatted = localDateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd"));

Q2：SimpleDateFormat和DateTimeFormatter性能差距大吗？