Java TimeZone 類完整指南：建立、常用 API、時區 ID 查詢與最佳實務

TimeZone 核心概念

java.util.TimeZone 代表時區偏移量與夏令時間規則。搭配 Date、Calendar 使用時，決定日期時間的「顯示」與「解析」行為。掌握 TimeZone 可避免跨時區系統的時間顯示錯誤。

建立 TimeZone 物件的兩種主要方式

1. 取得預設時區（JVM 啟動環境決定）

TimeZone defaultTz = TimeZone.getDefault();
// 例：執行環境在台灣 → "Asia/Taipei" (GMT+08:00)

2. 指定時區 ID 取得物件

// 標準 GMT 格式
TimeZone gmt8 = TimeZone.getTimeZone("GMT+08:00");

// 區域型 ID（推薦，自動處理夏令時間）
TimeZone taipei = TimeZone.getTimeZone("Asia/Taipei");
TimeZone newYork = TimeZone.getTimeZone("America/New_York");

查詢所有支援的時區 ID

String[] ids = TimeZone.getAvailableIDs();
for (String id : ids) {
    System.out.println(id);
}
// 輸出範例：Asia/Taipei, America/New_York, GMT+08:00, ...

亦可依偏移量（毫秒）篩選：

String[] ids = TimeZone.getAvailableIDs(8 * 3600 * 1000); // GMT+8 的所有 ID

常用 API 快速查閱

實務範例：同一瞬間在不同時區的顯示

public class TimeZoneDemo {
    public static void main(String[] args) {
        // 固定瞬間：2013-09-19 14:22:30 (預設時區)
        Date date = new Date(113, 8, 19, 14, 22, 30); // 年份-1900, 月份0-based

        DateFormat df = DateFormat.getInstance();

        // 預設時區
        printTime(date, df, TimeZone.getDefault());

        // GMT+08:00
        printTime(date, df, TimeZone.getTimeZone("GMT+08:00"));

        // Asia/Chongqing (中國標準時間)
        printTime(date, df, TimeZone.getTimeZone("Asia/Chongqing"));
    }

    static void printTime(Date date, DateFormat df, TimeZone tz) {
        df.setTimeZone(tz);
        System.out.printf("%-20s : %s%n", tz.getID(), df.format(date));
    }
}

輸出（視執行環境預設時區而異）：

Asia/Taipei          : 2013/9/19 下午 2:22
GMT+08:00            : 2013/9/19 下午 2:22
Asia/Chongqing       : 2013/9/19 下午 2:22

進階主題：JVM 預設時區決定機制與最佳實務

JVM 如何決定預設時區？

1. 讀取 System Property user.timezone
2. 若無，嘗試 user.country + java.home 推導
3. 仍失敗則回退 GMT

Windows 從登錄表讀取，Linux/Unix 從環境變數 TZ 讀取。

強制指定 JVM 時區（推薦部署時設定）

# 啟動參數指定
java -Duser.timezone=Asia/Taipei -jar app.jar

# 或程式碼早期設定（需在任何 Date/Calendar 使用前）
System.setProperty("user.timezone", "Asia/Taipei");
TimeZone.setDefault(TimeZone.getTimeZone("Asia/Taipei"));

格式化類別個別指定時區（更彈性）

DateFormat df = DateFormat.getDateTimeInstance();
df.setTimeZone(TimeZone.getTimeZone("America/New_York"));
String nyTime = df.format(new Date());

避坑指南

• 三字母縮寫不可靠：EST、CST 等有歧義，務必使用區域型 ID（如 America/New_York、Asia/Shanghai）。
• SimpleDateFormat 非執行緒安全，併發環境請用 ThreadLocal 或 Java 8 DateTimeFormatter。
• Java 8+ 新專案強烈建議改用 java.time 套件（ZoneId、ZonedDateTime），API 更完善、不可變、執行緒安全。