萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Java 日期時間處理大全:Calendar 實用工具類與 Java 8 新 API 對比

前言

Java 日期處理歷經 Date、Calendar 到 Java 8 java.time 三代演進。本文整理 Calendar 時代的經典工具類常用方法,並對照 Java 8+ 現代寫法,協助維護舊專案與新專案選型。

Calendar 經典工具類核心方法

以下為整理後的 DateUtils 關鍵方法(完整程式碼見附錄):

1. 基礎格式化與解析

// String <-> Date
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
Date date = sdf.parse("2009-11-04");
String str = sdf.format(date);

2. 相對日期計算

// 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);
}

3. 週/月/季/年 邊界計算

需求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,再設定日期

4. 取得星期幾

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 8+ java.time 現代寫法對比

強烈建議新專案直接使用 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)/86400000ChronoUnit.DAYS.between(d1, d2)
取得星期幾sdf.format("EEEE")localDate.getDayOfWeek() // 回傳 DayOfWeek enum
時區處理Calendar.getInstance(tz)ZonedDateTime.now(ZoneId.of("Asia/Taipei"))

Java 8 完整範例:常用日期邊界計算

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(); }
}

遷移建議與注意事項

  • SimpleDateFormat 非執行緒安全:舊代碼若共用 static 實例會有併發 Bug,Java 8 DateTimeFormatter 為不可變且 Thread-safe。
  • 時區預設陷阱:Calendar.getInstance() 使用 JVM 預設時區,部署環境不一致易出錯。Java 8 明確指定 ZoneId。
  • 資料庫交互:JDBC 4.2+ 直接支援 LocalDate/LocalDateTime,無需轉 java.sql.Date。
  • 序列化:java.time 類別實作 Serializable,Jackson/Gson 預設支援,無需額外配置。

附錄:Calendar 版工具類完整碼(精簡)

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 核心邏輯(加減時間、邊界計算、間隔計算)概念相通,對照表可快速轉換。

copyright © 萬盛學電腦網 all rights reserved