兩種時代的日期時間 API
| 特性 | 舊 API (java.util.Calendar/Date) | 新 API (java.time, Java 8+) |
| 設計 | 可變、非執行緒安全、月份 0-based | 不可變、執行緒安全、月份 1-based |
| 時區處理 | 麻煩、易出錯 | 內建 ZoneId、ZonedDateTime |
| 解析/格式化 | SimpleDateFormat(非執行緒安全) | DateTimeFormatter(執行緒安全) |
| 推薦程度 | 維護舊專案 | 所有新專案 |
舊 API 實作(Calendar)
package com.date.demo;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
public class DateDemo {
/** 取得當前時間的年月日時分秒 */
public static void getCurrentDateTime() {
Calendar cal = Calendar.getInstance(); // 預設時區、預設 Locale
int year = cal.get(Calendar.YEAR);
int month = cal.get(Calendar.MONTH) + 1; // 月份 0-11,需 +1
int day = cal.get(Calendar.DAY_OF_MONTH);
int hour = cal.get(Calendar.HOUR_OF_DAY); // 24 小時制
int minute = cal.get(Calendar.MINUTE);
int second = cal.get(Calendar.SECOND);
int millisecond = cal.get(Calendar.MILLISECOND);
System.out.printf("現在時間:%04d-%02d-%02d %02d:%02d:%02d.%03d%n",
year, month, day, hour, minute, second, millisecond);
}
/** 解析指定字串並取得各欄位 */
public static void parseCustomDateTime(String dateStr, String pattern) {
SimpleDateFormat sdf = new SimpleDateFormat(pattern);
// SimpleDateFormat 非執行緒安全,區域變數使用無虞;共用需同步或 ThreadLocal
Calendar cal = Calendar.getInstance();
try {
Date date = sdf.parse(dateStr);
cal.setTime(date);
} catch (ParseException e) {
throw new IllegalArgumentException("日期格式錯誤:" + dateStr, e);
}
int year = cal.get(Calendar.YEAR);
int month = cal.get(Calendar.MONTH) + 1;
int day = cal.get(Calendar.DAY_OF_MONTH);
int hour = cal.get(Calendar.HOUR_OF_DAY);
int minute = cal.get(Calendar.MINUTE);
int second = cal.get(Calendar.SECOND);
System.out.printf("解析結果:%04d-%02d-%02d %02d:%02d:%02d%n",
year, month, day, hour, minute, second);
}
public static void main(String[] args) {
getCurrentDateTime();
parseCustomDateTime("2013-11-10 18:45:39", "yyyy-MM-dd HH:mm:ss");
}
}
新 API 實作(java.time)—— 強烈推薦
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;
public class ModernDateTimeDemo {
/** 當前時間各欄位 */
public static void printNow() {
LocalDateTime now = LocalDateTime.now(); // 本地時間,無時區
int year = now.getYear();
int month = now.getMonthValue(); // 1-12
int day = now.getDayOfMonth();
int hour = now.getHour();
int minute = now.getMinute();
int second = now.getSecond();
int nano = now.getNano();
System.out.printf("現在:%04d-%02d-%02d %02d:%02d:%02d.%09d%n",
year, month, day, hour, minute, second, nano);
// 一次性取得多個欄位
System.out.println("年:" + now.get(ChronoField.YEAR));
System.out.println("季:" + now.get(ChronoField.QUARTER_OF_YEAR));
System.out.println("週:" + now.get(ChronoField.ALIGNED_WEEK_OF_YEAR));
}
/** 解析字串 */
public static void parseString(String str, String pattern) {
DateTimeFormatter fmt = DateTimeFormatter.ofPattern(pattern);
LocalDateTime dt = LocalDateTime.parse(str, fmt);
System.out.println("年:" + dt.getYear());
System.out.println("月:" + dt.getMonthValue());
System.out.println("日:" + dt.getDayOfMonth());
}
/** 帶時區解析 */
public static void parseWithZone(String str, String pattern, String zoneId) {
DateTimeFormatter fmt = DateTimeFormatter.ofPattern(pattern);
ZonedDateTime zdt = ZonedDateTime.parse(str, fmt.withZone(ZoneId.of(zoneId)));
System.out.println("UTC 時間:" + zdt.toInstant());
}
/** 格式化輸出 */
public static void formatOutput() {
LocalDateTime now = LocalDateTime.now();
DateTimeFormatter fmt = DateTimeFormatter.ofPattern("yyyy年MM月dd日 HH時mm分ss秒");
System.out.println("中文格式:" + now.format(fmt));
}
public static void main(String[] args) {
printNow();
parseString("2013-11-10 18:45:39", "yyyy-MM-dd HH:mm:ss");
formatOutput();
}
}
常見操作對照表
| 操作 | Calendar | java.time |
| 當前時間 | Calendar.getInstance() | LocalDateTime.now() |
| 指定日期建構 | cal.set(y, m-1, d, h, m, s) | LocalDateTime.of(y, m, d, h, m, s) |
| 取得年 | cal.get(Calendar.YEAR) | dt.getYear() / dt.get(ChronoField.YEAR) |
| 取得月 | cal.get(Calendar.MONTH)+1 | dt.getMonthValue() / dt.getMonth() |
| 加減天數 | cal.add(Calendar.DAY, n) | dt.plusDays(n) / dt.minusDays(n) |
| 兩日期差天數 | (d2.getTime()-d1.getTime())/86400000 | ChronoUnit.DAYS.between(d1, d2) |
| 格式化 | new SimpleDateFormat(pattern).format(date) | dt.format(DateTimeFormatter.ofPattern(pattern)) |
| 解析 | sdf.parse(str) | LocalDateTime.parse(str, formatter) |
遷移建議
- 新專案直接使用
java.time
- 舊專案逐步替換:
Date.toInstant() ↔ Date.from(instant) 橋接
- 資料庫層:JDBC 4.2+ 直接支援
LocalDateTime、LocalDate、Instant
- JSON 序列化:Jackson 需註冊
JavaTimeModule
總結
Calendar 雖仍可用,但設計缺陷明顯。Java 8 java.time 系列 API 解決了所有歷史包袱,語意清晰、執行緒安全、功能豐富。投資時間學習新 API,將在長期維護中獲得巨大回報。