Java 中 String、Date、Timestamp 相互轉換完整指南與最佳實踐

前言

日期時間處理是 Java 開發高頻痛點：格式不匹配、時區陷阱、java.util.Date 與 java.sql.Timestamp 繼承關係導致的精度遺失。本文系統整理三者互轉代碼模板，並針對常見坑點給出規避方案。

一、String ⇄ java.util.Date

1.1 String → Date (解析)

String dateStr = "2024/06/15 14:30:00";
SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss");
try {
    Date date = sdf.parse(dateStr); // 拋 ParseException 需捕獲
    System.out.println(date); // Sat Jun 15 14:30:00 CST 2024
} catch (ParseException e) {
    e.printStackTrace();
}

⚠️ 線程安全警示：SimpleDateFormat 非線程安全，多線程環境請用 ThreadLocal 或 Java 8+ DateTimeFormatter。

1.2 Date → String (格式化)

Date date = new Date();
// 可任意自訂格式
DateFormat sdf1 = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss");
DateFormat sdf2 = new SimpleDateFormat("yyyy-MM-dd HH/mm/ss");
System.out.println(sdf1.format(date)); // 2024/06/15 14:30:00
System.out.println(sdf2.format(date)); // 2024-06-15 14/30/00

二、String ⇄ java.sql.Timestamp

2.1 String → Timestamp

String tsStr = "2024-06-15 14:30:00.123"; // 必須符合 yyyy-MM-dd HH:mm:ss[.f...]
Timestamp ts = Timestamp.valueOf(tsStr); // 靜態工廠方法
System.out.println(ts); // 2024-06-15 14:30:00.123

格式嚴格：不符合標準格式會拋 IllegalArgumentException，非標準字串請先用 SimpleDateFormat 解析為 Date 再轉 Timestamp。

2.2 Timestamp → String

Timestamp ts = new Timestamp(System.currentTimeMillis());
// 方式一：自訂格式 (推薦)
String custom = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss").format(ts);
// 方式二：預設 toString() 輸出 yyyy-MM-dd HH:mm:ss.fffffffff
String defaultStr = ts.toString();

三、Date ⇄ Timestamp 互轉 (父子類關係)

Timestamp extends Date，故 向上轉型無損，向下轉型需強轉。

3.1 Timestamp → Date (隱式向上轉型)

Timestamp ts = new Timestamp(System.currentTimeMillis());
Date date = ts; // 自動向上轉型
// 注意：date 實際仍指向 Timestamp 物件，getTime() 保留納秒精度

3.2 Date → Timestamp (兩種安全做法)

Date date = new Date();

// 方式一：經由 long 毫秒值 (推薦，無精度損失)
Timestamp ts1 = new Timestamp(date.getTime());

// 方式二：若 date 實際是 Timestamp 實例，可強轉
if (date instanceof Timestamp) {
    Timestamp ts2 = (Timestamp) date;
}

四、資料庫交互最佳實踐 (JDBC / MyBatis / JPA)

五、現代化替代方案：Java 8+ java.time 包

// 解析
LocalDateTime ldt = LocalDateTime.parse("2024-06-15T14:30:00", DateTimeFormatter.ISO_LOCAL_DATE_TIME);
// 格式化
String str = ldt.format(DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss"));
// 與舊 API 互通
Date date = Date.from(ldt.atZone(ZoneId.systemDefault()).toInstant());
Timestamp ts = Timestamp.valueOf(ldt);

強烈建議：新專案全面遷移至 java.time.*，線程安全、不可變、API 清晰，徹底解決舊 API 歷史包袱。

六、總結速查表