Java 時間處理系列 (4)：DateFormat 抽象工廠與預定義風格

DateFormat 定位

java.text.DateFormat 是抽象基類，提供預定義風格 (SHORT/MEDIUM/LONG/FULL) 的工廠方法，實際返回 SimpleDateFormat 實例。適用於快速獲得本地化標準格式，不需手寫模式。

四大預定義風格

核心工廠方法 (全部返回 SimpleDateFormat)

getInstance()                          // SHORT 日期+時間
getDateInstance()                      // MEDIUM 日期
getDateInstance(int style)             // 指定風格日期
getDateInstance(int style, Locale)     // 指定風格+區域日期
getTimeInstance()                      // MEDIUM 時間
getTimeInstance(int style)             // 指定風格時間
getTimeInstance(int style, Locale)     // 指定風格+區域時間
getDateTimeInstance()                  // MEDIUM 日期+時間
getDateTimeInstance(int dStyle, int tStyle)           // 指定風格日期+時間
getDateTimeInstance(int dStyle, int tStyle, Locale)   // 指定風格+區域日期+時間

源碼揭秘：工廠方法內部調用

private static DateFormat get(int timeStyle, int dateStyle, int flags, Locale loc) {
    // flags: 1=時間, 2=日期, 3=日期時間
    // 校驗 style 範圍 0-3
    // 嘗試 SPI 獲取提供者實現
    return new SimpleDateFormat(timeStyle, dateStyle, loc);
}

JDK 通過 LocaleServiceProvider SPI 允許第三方擴展本地化格式化實現。

實戰代碼

Date date = new Date();
Locale cn = Locale.SIMPLIFIED_CHINESE;

// 時間風格
System.out.println("SHORT: "   + DateFormat.getTimeInstance(DateFormat.SHORT, cn).format(date));
System.out.println("MEDIUM: "  + DateFormat.getTimeInstance(DateFormat.MEDIUM, cn).format(date));
System.out.println("LONG: "    + DateFormat.getTimeInstance(DateFormat.LONG, cn).format(date));
System.out.println("FULL: "    + DateFormat.getTimeInstance(DateFormat.FULL, cn).format(date));

// 日期風格
System.out.println("Date SHORT: "  + DateFormat.getDateInstance(DateFormat.SHORT, cn).format(date));
System.out.println("Date FULL: "   + DateFormat.getDateInstance(DateFormat.FULL, cn).format(date));

// 日期時間組合
System.out.println("DateTime LONG/SHORT: " + 
    DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.SHORT, cn).format(date));

格式化對象方法

format(Date date) → String                    // 最常用
format(Object obj, StringBuffer, FieldPosition) // 底層多態入口

解析方法

parse(String source) → Date                   // 全字符串解析
parse(String source, ParsePosition pos) → Date // 部分解析，pos 更新索引

常用配置方法

• setTimeZone(TimeZone) 設置時區
• setLenient(boolean) 寬鬆模式 (默認 true，允許 2月30日 自動轉 3月2日)
• setCalendar(Calendar) 替換底層日曆 (罕用)

選型建議

• 需標準本地化格式 → DateFormat.getXxxInstance()
• 需自定義模式/解析非標準格式 → new SimpleDateFormat(pattern)
• Java 8+ 新項目 → java.time.format.DateTimeFormatter (線程安全、功能更強)