Java 日期處理歷經 Date、Calendar 到 Java 8 java.time 三代演進。本文整理 Calendar 時代的經典工具類常用方法,並對照 Java 8+ 現代寫法,協助維護舊專案與新專案選型。
以下為整理後的 DateUtils 關鍵方法(完整程式碼見附錄):
// String <-> Date
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
Date date = sdf.parse("2009-11-04");
String str = sdf.format(date);
// N個月後/前
public static String getAfterMonth(int months, String baseDate) {
Calendar c = Calendar.getInstance();
c.setTime(sdf.parse(baseDate));
c.add(Calendar.MONTH, months);
return sdf.format(c.getTime());
}
// 兩日期間隔天數
public static long getDaysBetween(String date1, String date2) {
Date d1 = sdf.parse(date1);
Date d2 = sdf.parse(date2);
return (d1.getTime() - d2.getTime()) / (24 * 60 * 60 * 1000);
}
| 需求 | Calendar 關鍵邏輯 |
|---|---|
| 本週一/週日 | 設定 Calendar.DAY_OF_WEEK = Calendar.MONDAY/SUNDAY |
| 上/下週一/週日 | 在本週基礎上 add(Calendar.WEEK_OF_YEAR, -1/1) |
| 本月第一天/最後一天 | set(Calendar.DAY_OF_MONTH, 1) / add(MONTH,1); add(DATE,-1) |
| 上/下月第一天/最後一天 | 在本月基礎上 add(MONTH, -1/1) |
| 本年第一天/最後一天 | set(MONTH, 0); set(DATE, 1) / set(MONTH, 11); set(DATE, 31) |
| 季度首尾 | 根據月份計算季度起始月 (month/3)*3,再設定日期 |
public static String getWeek(String dateStr) {
Date date = sdf.parse(dateStr);
Calendar c = Calendar.getInstance();
c.setTime(date);
return new SimpleDateFormat("EEEE").format(c.getTime()); // 完整名稱:Monday
// 或 "E" 縮寫:Mon
}
強烈建議新專案直接使用 java.time 套件(Thread-safe、不可變、API 直觀)。
| 場景 | Calendar (舊) | java.time (新) |
|---|---|---|
| 當前日期 | Calendar.getInstance() | LocalDate.now() |
| 當前日期時間 | new Date() | LocalDateTime.now() |
| 解析字串 | sdf.parse(str) | LocalDate.parse(str, DateTimeFormatter.ofPattern("yyyy-MM-dd")) |
| 格式化輸出 | sdf.format(date) | date.format(DateTimeFormatter.ofPattern("yyyy-MM-dd")) |
| 加減月份 | cal.add(MONTH, 6) | localDate.plusMonths(6) |
| 本月第一天 | set(DAY_OF_MONTH,1) | localDate.withDayOfMonth(1) |
| 本月最後一天 | add(MONTH,1); add(DATE,-1) | localDate.withDayOfMonth(localDate.lengthOfMonth()) |
| 兩日期間隔天數 | (d1-d2)/86400000 | ChronoUnit.DAYS.between(d1, d2) |
| 取得星期幾 | sdf.format("EEEE") | localDate.getDayOfWeek() // 回傳 DayOfWeek enum |
| 時區處理 | Calendar.getInstance(tz) | ZonedDateTime.now(ZoneId.of("Asia/Taipei")) |
import java.time.*;
import java.time.temporal.*;
import java.time.format.*;
public class ModernDateUtils {
private static final DateTimeFormatter FMT = DateTimeFormatter.ofPattern("yyyy-MM-dd");
public static String now() { return LocalDate.now().format(FMT); }
public static String firstDayOfMonth() { return LocalDate.now().withDayOfMonth(1).format(FMT); }
public static String lastDayOfMonth() {
return LocalDate.now().withDayOfMonth(LocalDate.now().lengthOfMonth()).format(FMT);
}
public static String firstDayOfLastMonth() {
return LocalDate.now().minusMonths(1).withDayOfMonth(1).format(FMT);
}
public static String lastDayOfLastMonth() {
return LocalDate.now().withDayOfMonth(1).minusDays(1).format(FMT);
}
public static String firstDayOfYear() { return LocalDate.now().withDayOfYear(1).format(FMT); }
public static String lastDayOfYear() { return LocalDate.now().withDayOfYear(LocalDate.now().lengthOfYear()).format(FMT); }
public static long daysBetween(String d1, String d2) {
return ChronoUnit.DAYS.between(LocalDate.parse(d1, FMT), LocalDate.parse(d2, FMT));
}
public static String plusMonths(int months) { return LocalDate.now().plusMonths(months).format(FMT); }
public static DayOfWeek dayOfWeek(String date) { return LocalDate.parse(date, FMT).getDayOfWeek(); }
}
DateTimeFormatter 為不可變且 Thread-safe。Calendar.getInstance() 使用 JVM 預設時區,部署環境不一致易出錯。Java 8 明確指定 ZoneId。LocalDate/LocalDateTime,無需轉 java.sql.Date。java.time 類別實作 Serializable,Jackson/Gson 預設支援,無需額外配置。public class LegacyDateUtils {
private static final SimpleDateFormat SDF = new SimpleDateFormat("yyyy-MM-dd");
public static String getAfterMonth(int month) { ... }
public static String getTwoDay(String sj1, String sj2) { ... }
public static String getWeek(String sdate) { ... }
public static Date strToDate(String strDate) { ... }
public static long getDays(String date1, String date2) { ... }
public static String getDefaultDay() { ... } // 本月最後一天
public static String getPreviousMonthFirst() { ... } // 上月第一天
public static String getFirstDayOfMonth() { ... } // 本月第一天
public static String getCurrentWeekday() { ... } // 本週日
// ... 其他上/下週、上/下月、上/下年、季度邊界方法
}
維護舊專案請沿用 Calendar 工具類並注意執行緒安全;新專務必採用 java.time,API 更清晰、效能更好、避免大量歷史坑點。兩套 API 核心邏輯(加減時間、邊界計算、間隔計算)概念相通,對照表可快速轉換。