Java SimpleDateFormat 線程安全陷阱與最佳實踐指南

SimpleDateFormat 是 Java 格式化/解析日期的核心工具，但**非線程安全**是著名坑點。本文系統講解格式模式字母、線程安全問題、高性能替代方案與現代 API 遷移指南。

一、格式模式字母完整表

二、基本用法示例

SimpleDateFormat sdf1 = new SimpleDateFormat("yyyy年MM月dd日 HH時mm分ss秒");
SimpleDateFormat sdf2 = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
SimpleDateFormat sdf3 = new SimpleDateFormat("yyyy年MM月dd日 HH時mm分ss秒 E");

Date now = new Date();
System.out.println(sdf1.format(now)); // 2024年07月10日 14時30分45秒
System.out.println(sdf2.format(now)); // 2024-07-10 14:30:45
System.out.println(sdf3.format(now)); // 2024年07月10日 14時30分45秒 星期三

// 解析
Date parsed = sdf2.parse("2024-07-10 14:30:45");

三、線程安全核心問題

• SimpleDateFormat 內部持有共享 Calendar 實例
• 多線程並發 format()/parse() 會導致數據競爭，產生錯誤結果或拋出 NumberFormatException/ArrayIndexOutOfBoundsException

四、四種解決方案對比

五、推薦：ThreadLocal 單例模式 (Java 7 環境必備)

public class DateFormatUtils {
    private static final ThreadLocal SDF_THREAD_LOCAL =
        ThreadLocal.withInitial(() -> new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));

    public static String format(Date date) {
        return SDF_THREAD_LOCAL.get().format(date);
    }
    public static Date parse(String str) throws ParseException {
        return SDF_THREAD_LOCAL.get().parse(str);
    }
    // 應用關閉時清理（可選）
    public static void clear() { SDF_THREAD_LOCAL.remove(); }
}

六、現代遷移：DateTimeFormatter (Java 8+)

import java.time.*;
import java.time.format.DateTimeFormatter;

public class ModernDateFormat {
    private static final DateTimeFormatter FMT = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    public static String format(LocalDateTime ldt) { return FMT.format(ldt); }
    public static LocalDateTime parse(String str) { return LocalDateTime.parse(str, FMT); }

    // 舊 Date 互轉
    public static String format(Date date) {
        return FMT.format(date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime());
    }
    public static Date parseToDate(String str) {
        return Date.from(LocalDateTime.parse(str, FMT)
            .atZone(ZoneId.systemDefault()).toInstant());
    }
}

七、工具類封裝建議

public class DateUtils {
    // 線程安全格式化器緩存
    private static final Map FMT_CACHE = new ConcurrentHashMap<>();

    public static DateTimeFormatter getFormatter(String pattern) {
        return FMT_CACHE.computeIfAbsent(pattern, DateTimeFormatter::ofPattern);
    }

    public static String format(LocalDateTime ldt, String pattern) {
        return getFormatter(pattern).format(ldt);
    }
    public static LocalDateTime parse(String str, String pattern) {
        return LocalDateTime.parse(str, getFormatter(pattern));
    }
    // Date 互轉略
}

八、總結建議

1. **新項目強制使用 java.time + DateTimeFormatter**，從源頭杜絕線程安全問題
2. 存量代碼若無法全量遷移，統一接入 ThreadLocal 工具類
3. 禁用 static SimpleDateFormat 共享實例，Code Review 必檢項
4. 格式化模式常量化，避免魔法字符串散落

掌握 SimpleDateFormat 線程安全本質與現代替代方案，是 Java 開發者進階的必修課。

1. 上一篇文章： Java程序自動重啟實現方案：定時重啟與異常自愈
2. 下一篇文章： Java按字節截取字符串並保證中文字符不拆分實現

Java 相關知識

GEF 入門系列（序）：學習指南與範例介紹

因工作需要，最近開始研究 GEF（Graphical Edi

Tomcat 系統架構與設計模式（第 1 部分）：核心工作原理解析

本文以 Tomcat 5 為基礎，也兼顧最新的 Tomcat

Struts2 輸入驗證（一）：validate 方法與 validateXxx 方法詳解

編程式驗證：重寫 validate() 繼承 ActionS

Spring MVC 文件上傳完整指南：單檔、多檔、MultipartFile 實戰與配置避坑

Spring MVC 以 MultipartFile 封裝上