Java 日期與字符串互轉完全指南：SimpleDateFormat 模式、解析異常、線程安全與最佳實踐

Java 日期與字符串互轉完全指南：SimpleDateFormat 模式、解析異常、線程安全與最佳實踐

Web 開發中，前端傳遞字符串日期，後端需解析為 Date 存入數據庫；查詢時再格式化為字符串返回前端。SimpleDateFormat 是 JDK 7 及之前的標準工具，但存在線程不安全、模式匹配嚴格等坑點，本文系統總結。

核心類結構

• DateFormat：抽象父類，定義 format(Date)/parse(String)。
• SimpleDateFormat：具體實現，支持自定義模式。
• FastDateFormat (Apache Commons Lang)：線程安全、不可變，推薦替代。

常用模式字母

日期 → 字符串 (格式化)

Date date = new Date();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
System.out.println(sdf.format(date)); // 2024-01-15

sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
System.out.println(sdf.format(date)); // 2024-01-15 14:30:45

sdf = new SimpleDateFormat("yyyy年MM月dd日 HH:mm:ss");
System.out.println(sdf.format(date)); // 2024年01月15日 14:30:45

字符串 → 日期 (解析)

String str = "2024-01-15 14:30:45";
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
Date date = sdf.parse(str); // 拋 ParseException，需 try-catch

模式匹配規則與常見異常

規則：解析時，字符串必須包含模式要求的所有字段；模式可比字符串短 (忽略尾部)，不能比字符串長 (缺字段報錯)。

線程安全陷阱與解決方案

SimpleDateFormat 非線程安全：內部 Calendar 實例共享，併發調用 format/parse 會導致數據錯亂、拋 ArrayIndexOutOfBoundsException 或結果錯誤。

方案對比

空值/異常防禦編程

// 判空比較：推薦模式
if (str == null || str.trim().isEmpty()) return null;
try {
    return sdf.parse(str);
} catch (ParseException e) {
    log.warn("日期解析失敗: {}", str, e);
    return null; // 或拋業務異常
}

最佳實踐清單

1. 項目統一使用 FastDateFormat (JDK 7) 或 DateTimeFormatter (JDK 8+)，禁用 SimpleDateFormat 實例共享。
2. 定義常量模式字符串，避免硬編碼分散：DATE_PATTERN = "yyyy-MM-dd"。
3. 解析前預處理：去除空格、統一分隔符、補齊零寬字段。
4. 數據庫存儲統一用 UTC 時間戳 (BIGINT) 或 TIMESTAMP WITH TIME ZONE，展示層按用戶時區格式化。
5. 序列化框架 (Jackson/Fastjson) 配置統一日期格式，避免雙向轉換不一致。