還在用Calendar操作Date？Java8都棄用了，還不知道它的這款強大的工具嗎？

引言

在過去的Java版本中，日期和時間的處理主要依賴於java.util.Date和java.util.Calendar類，然而隨著業務系統的複雜以及技術層面的提升，這些傳統的日期時間類暴露出了若干顯著的不足之處。隨著Java8的釋出，其引入了一套全新的日期時間API，徹底改變了我們處理日期和時間的方式。

傳統的日期時間類

相比較Java8中新引入的java.time包下的時間處理類，傳統的日期時間處理類在易用性，執行緒安全，不支援市時區等缺點。

1. 設計複雜性：Date類的設計較為簡單，但它實際上混合了日期和時間資訊，並且沒有提供直觀的方法來單獨操作日期或時間部分。Calendar類雖然提供了更多靈活性，但由於其內部狀態和方法的複雜性，使得開發者在使用過程中容易出現錯誤和混淆，尤其是在進行日期時間計算和格式化時。比如：

Date currentDate = new Date();  
// 輸出原始的日期時間，通常不是人類可讀格式   Fri Mar 08 03:13:47 CST 2024
System.out.println(currentDate);

// 要改變日期的某個部分，必須先將其轉換為 Calendar，然後設定  
Calendar calendar = Calendar.getInstance();  
calendar.setTime(currentDate);  
// 修改日期的天數  
calendar.add(Calendar.DAY_OF_MONTH, 1);

2. 執行緒安全性：Date和 Calendar類，以及格式化日期的SimpleDateFormat類都不是執行緒安全的，這意味著在多執行緒環境下的併發訪問可能會導致資料不一致。

   • Date類內部維護了一個 long 型別的瞬時值，當呼叫如setTime()方法來更新這個瞬時值時，不同的執行緒同時呼叫就會互相覆蓋彼此的值，造成資料不一致。

   • Calendar類不僅包含了日期和時間資訊，還有一系列內部狀態變數，如年、月、日、小時、分鐘、秒等。Calendar類的方法通常會修改這些內部狀態，例如 add()、set() 等。在多執行緒環境下，若多個執行緒嘗試同時修改同一個 Calendar 例項，也會導致不可預期的結果。

   • SimpleDateFormat類在執行格式化和解析日期時間操作時，內部會維護一個 Calendar物件以及其他一些狀態變數。在 format() 或 parse() 方法執行過程中，這些狀態會被更新以完成格式轉換。並且SimpleDateFormat中的方法並非原子操作，因此在多執行緒併發呼叫時，可能在一個執行緒還未完成整個操作時就被另一個執行緒打斷，導致錯誤的日期時間處理結果。

3. 時區處理能力：Date類雖能表示時間戳，但它不直接關聯時區資訊，難以進行時區相關的轉換。而 Calendar 雖然支援時區，但操作過程相當複雜。

4. 精度差異：Date類精度只到毫秒級。

Java8中日期時間類

Java8中引入的LocalDate，LocalTime，LocalDateTime這幾個位於java.time下的類克服了上述傳統類別的侷限性，提供了更強大、直觀和精準的日期時間處理能力，成為現代Java開發中處理日期時間首選的工具類。相比較傳統的日期時間類，具備以下顯著優勢：

1. 功能豐富
   java.time包下的類如 LocalDate、LocalTime、LocalDateTime、ZonedDateTime 等都有明確的職責劃分，分別處理日期、時間、日期時間以及帶時區的日期時間，結構清晰，易於理解和使用。並且它們提供了一系列直觀、物件導向的API，如 plusXxx()、minusXxx()、withXxx()等方法，使日期時間操作變得簡單明瞭。

2. 時區支援
   除此之外，還支援時區，透過ZonedDateTime和 ZoneId等類提供了對時區的更好支援，可以方便地進行時區轉換和處理。

3. 執行緒安全
   這些類都是不可變物件，執行緒安全，可以在多執行緒環境下安全使用，不會出現因併發操作導致的資料不一致問題。

4. 更高的精度
   支援納秒級精度，相比 Date 類的毫秒精度更勝一籌。

java.time下主要有如下一些關鍵類：

1. LocalDate
   LocalDate類表示一個不包含時間資訊的日期，只包含年、月、日三個部分，且不關聯任何特定時區。

2. LocalTime
   LocalTime類表示一個不包含日期資訊的具體時間，包含時、分、秒和納秒四個部分。

3. LocalDateTime
   LocalDateTime類結合了日期和時間，表示一個具體的日期和時間點，但是不包含時區資訊。

4. ZonedDateTime
   ZonedDateTime類表示一個帶有時區的日期時間，它可以明確表示某一特定時區內的某一確切時間點。

5. Instant
   Instant類表示時間線上某一瞬時點，通常以Unix紀元（1970-01-01T00:00:00Z）以來的秒數和納秒數表示，它是全球通用的時間點表示。

6. Period
   Period類用於表示兩個日期之間的期間，包括年、月、日的數量。

7. Duration
   Duration類表示兩個時間點之間的時間差，包含秒和納秒的持續時間，主要用於表示時間間隔而非日曆單位。

8. DateTimeFormatter
   DateTimeFormatter類用於日期時間的格式化和解析，提供了標準化和自定義的日期時間格式化方式。

9. TemporalAdjusters
   TemporalAdjusters類提供了一系列實用方法，用於調整日期時間，例如獲取下一個工作日、月初、月末等。

這些類共同構成了一個強大、靈活且易於使用的日期時間處理體系，大大改善了Java在處理日期時間問題時的效率和準確性。接下來我們在使用上分別介紹這些類，以及使用他們的方式，感受他們的強大。

Java8中日期時間類使用

建立

NOW方法獲取當前 時刻、日期、時間

LocalTime localTime = LocalTime.now();  
System.out.println("localTime："+localTime);  
  
LocalDate localDate = LocalDate.now();  
System.out.println("localDate："+localDate);  
  
LocalDateTime localDateTime = LocalDateTime.now();  
System.out.println("localDateTime："+localDateTime);

輸出為：

localTime：15:28:45.241181
localDate：2024-03-11
localDateTime：2024-03-11T15:28:45.260655

針對LocalTime，LocalDateTime獲取當前時刻預設會帶有毫秒，如果不需要毫秒的話，可以透過設定納秒為0 保留秒 1秒 = 十億納秒 。例如：

LocalTime localTime = LocalTime.now().withNano(0);
System.out.println("localTime："+localTime);  

LocalDateTime localDateTime = LocalDateTime.now().withNano(0);  
System.out.println("localDateTime："+localDateTime);

輸出為：

localTime：15:32:31
localDateTime：2024-03-11T15:32:31

而對於LocalDateTime獲取當前日期，預設toString會帶有T分隔日期和時間,在專案中，可以透過全域性序列化，進行統一的時間格式輸出為 yyyy-MM-dd HH:mm:ss。但是一般不建議這麼幹，畢竟改變全域性序列化配置，建議不使用toString，可以使用DateTimeFormatter進行自定義轉換。

of()方法指定年、月、日、時刻建立

// of方法直接傳遞對應的年、月、日  
LocalDate localDate = LocalDate.of(2024, 3, 11);  
System.out.println("localDate："+localDate);  
localDate = LocalDate.of(2024, Month.MARCH, 11);  
System.out.println("localDate："+localDate);  
localDate = LocalDate.ofYearDay(2024, 71);  
System.out.println("localDate："+localDate);  
  
// 北京時間對應的時區  
ZoneId chinaTimeZone = ZoneId.of("Asia/Shanghai");  
// 建立一個 Instant，這裡使用當前時間的 InstantInstant instant = Instant.now();  
localDate = LocalDate.ofInstant(instant, chinaTimeZone);  
System.out.println("localDate："+localDate);  
  
// 使用ofEpochDay()方法，則EpochDay為從公元1970年1月1日（Unix紀元）開始的第多少天  
localDate = LocalDate.ofEpochDay(LocalDate.now().toEpochDay());  
System.out.println("localDate："+localDate);  
  
  
LocalTime localTime = LocalTime.of(1, 30);  
System.out.println("localTime："+localTime);  
localTime = LocalTime.of(1, 30, 30);  
System.out.println("localTime："+localTime);  
  
localTime = LocalTime.ofInstant(instant, chinaTimeZone);  
System.out.println("localTime："+localTime);  
// 根據一天中的總秒數構建時間
localTime = LocalTime.ofSecondOfDay(localTime.toSecondOfDay());  
System.out.println("localTime："+localTime);  
  
  
LocalDateTime localDateTime = LocalDateTime.of(2024, 3, 11, 1, 30, 30);  
System.out.println("localDateTime："+localDateTime);  
localDateTime = LocalDateTime.of(2024, Month.MARCH, 11, 1, 30, 30);  
System.out.println("localDateTime："+localDateTime);  
// 使用LocalDate和LocalTime組合構造  
localDateTime = LocalDateTime.of(localDate, localTime);  
System.out.println("localDateTime："+localDateTime);  
  
localDateTime = LocalDateTime.ofInstant(instant, chinaTimeZone);  
System.out.println("localDateTime："+localDateTime);

輸出為：

localDate：2024-03-11
localDate：2024-03-11
localDate：2024-03-11
localDate：2024-03-11
localDate：2024-03-11
localTime：01:30
localTime：01:30:30
localTime：16:41:37.893310
localTime：16:41:37
localDateTime：2024-03-11T01:30:30
localDateTime：2024-03-11T01:30:30
localDateTime：2024-03-11T16:41:37
localDateTime：2024-03-11T16:41:37.893310

from()方法轉換

from()方法將TemporalAccessor型別（如ZonedDateTime）轉換為相對應的日期或者時間。TemporalAccessor介面是一個用於讀取或寫入日期、時間或者日期時間的通用介面。

// 建立一個ZonedDateTime例項  
ZonedDateTime zonedDateTime = ZonedDateTime.now(ZoneId.of("Asia/Shanghai"));  
LocalTime localTime = LocalTime.from(zonedDateTime);  
System.out.println("localTime："+localTime);  

LocalDate localDate = LocalDate.from(zonedDateTime);  
System.out.println("localDate："+localDate);  

LocalDateTime localDateTime = LocalDateTime.from(zonedDateTime);  
System.out.println("localDateTime："+localDateTime);

輸出為：

localTime：17:18:27.942911
localDate：2024-03-11
localDateTime：2024-03-11T17:18:27.942911

parse()方法轉換

將字串按照指定格式（可選）解析為對應的日期時間類。

LocalTime localTime = LocalTime.parse("17:25:30");  
System.out.println("localTime："+localTime);  
localTime = LocalTime.parse("17:25:30", DateTimeFormatter.ofPattern("HH:mm:ss"));  
System.out.println("localTime："+localTime);  
  
LocalDate localDate = LocalDate.parse("2024-03-11");  
System.out.println("localDate："+localDate);  
localDate = LocalDate.parse("2024/03/11", DateTimeFormatter.ofPattern("yyyy/MM/dd"));  
System.out.println("localDate："+localDate);  
  
LocalDateTime localDateTime = LocalDateTime.parse("2024-03-11T17:25:30");  
System.out.println("localDateTime："+localDateTime);  
localDateTime = LocalDateTime.parse("2024/03/11 17:25:30", DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss"));  
System.out.println("localDateTime："+localDateTime);

輸出為：

localTime：17:25:30
localTime：17:25:30
localDate：2024-03-11
localDate：2024-03-11
localDateTime：2024-03-11T17:25:30
localDateTime：2024-03-11T17:25:30

日期時間類的相互轉換

LocalTime、LocalDate、LocalDateTime 相互轉化

// LocalTime + LocalDate = LocalDateTime
LocalDateTime localDateTime = LocalTime.now().atDate(LocalDate.now());
System.out.println("localDateTime："+localDateTime);
localDateTime = LocalDate.now().atTime(LocalTime.now());
System.out.println("localDateTime："+localDateTime);
localDateTime = LocalDateTime.of(LocalDate.now(), LocalTime.now());
System.out.println("localDateTime："+localDateTime);

// LocalDateTime 轉 LocalDate
LocalDate localDate = LocalDateTime.now().toLocalDate();
System.out.println("localDate："+localDate);
// LocalDateTime 轉 LocalTime
LocalTime localTime = LocalDateTime.now().toLocalTime();
System.out.println("localTime："+localTime);

// 獲取今日開始時間 2024-03-11T00:00
localDateTime = LocalDate.now().atStartOfDay();
System.out.println("localDateTime："+localDateTime);
// 獲取今日開始時間 2024-03-11T00:00
LocalDateTime startDateTime = LocalDateTime.of(LocalDate.now(), LocalTime.MIN);
System.out.println("startDateTime："+ startDateTime);
// 獲取今日結束時間 2024-03-11T23:59:59.999999999
LocalDateTime endDateTime = LocalDateTime.of(LocalDate.now(), LocalTime.MAX);
System.out.println("endDateTime："+ endDateTime); 

輸出為：

localDateTime：2024-03-11T18:04:22.348539
localDateTime：2024-03-11T18:04:22.370562
localDateTime：2024-03-11T18:04:22.370768
localDate：2024-03-11
localTime：18:04:22.371062
localDateTime：2024-03-11T00:00
startDateTime：2024-03-11T00:00
endDateTime：2024-03-11T23:59:59.999999999

String 與 LocalTime、LocalDate、LocalDateTime 相互轉化

主要使用format 和 parse 進行轉換，使用方法基本相同。使用 DateTimeFormatter.ofPattern() 定義時間格式，再進行轉換。
DateTimeFormatter執行緒安全。

// LocalTime 轉 String 自定義輸出格式，例如：**時**分**秒 該轉化的 00 不會被省略
String localTimeStr = LocalTime.now().format(DateTimeFormatter.ofPattern("HH時mm分ss秒"));
System.out.println("localTimeStr:"+localTimeStr);

String localDateStr = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd"));
System.out.println("localDateStr:"+localDateStr);

// LocalDateTime 轉 String
String localDateTimeStr = LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
System.out.println("localDateTimeStr:"+localDateTimeStr);

// String 轉 LocalDateTime
LocalDateTime localDateTime = LocalDateTime.parse("2023-04-14 15:59:40", DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
System.out.println("localDateTime："+localDateTime);

輸出結果：

localTimeStr:19時02分58秒
localDateStr:2024-03-11
localDateTimeStr:2024-03-11 19:02:58
localDateTime：2023-04-14T15:59:40

Date 與 LocalDate、LocalDateTime 相互轉化

// Date 轉 LocalDateTime
Date currentDate = new Date();
// 轉換為Instant 
Instant instant = currentDate.toInstant();
// 透過zoneId設定時區(這裡使用系統時區)，轉換為帶帶時區的 ZoneDateTime
ZonedDateTime zonedDateTime = instant.atZone(ZoneId.systemDefault());
// 然後透過ZonedDateTime轉換為LocalDateTime
LocalDateTime localDateTime = zonedDateTime.toLocalDateTime();
System.out.println("localDateTime："+localDateTime);
// LocalDateTime 轉 Date，同理也是透過ZonedDateTime轉換為Date
Date localDateTimeToDate = Date.from(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant());
System.out.println(localDateTimeToDate);
// Date轉LocalDate 同理 LocalDateTime轉換
LocalDate localDate = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();
System.out.println("localDate："+localDate);
// LocalDate 轉 Date  需要先將 LocalDate 轉 LocalDateTime
Date localDateToDate = Date.from(LocalDate.now().atStartOfDay(ZoneId.systemDefault()).toInstant());

這裡介紹一下ZoneId。java.time.ZoneId是Java 8中java.time包中用於表示時區的類。時區是地球上的地理位置，用於確定在該位置觀察太陽昇落以及規定當地居民生活和商業活動時間的標準時間。ZoneId使用IANA時區資料庫提供的時區識別符號，這個識別符號是唯一的，這些識別符號通常是地區/城市對，例如“Asia/Shanghai”代表中國上海所在的時區，America/New_York代表美國紐約城市。
其例項獲取有兩種方式：

• ZoneId.systemDefault()：獲取系統預設的時區ID。
• ZoneId.of(String zoneId)：根據提供的時區ID字串獲取ZoneId例項。至於zoneId的值，可以檢視原始碼。可以透過ZoneId.getAvailableZoneIds()檢視獲取。

Long 與 LocalDate、LocalDateTime 相互轉化

時間戳轉換。

long timeMillis = System.currentTimeMillis();

// 時間戳(Long) 轉 LocalDateTime
LocalDateTime localDateTime = Instant.ofEpochMilli(timeMillis).atZone(ZoneOffset.ofHours(8)).toLocalDateTime();
System.out.println("localDateTime："+localDateTime);
localDateTime = Instant.ofEpochMilli(timeMillis).atZone(ZoneId.systemDefault()).toLocalDateTime();
System.out.println("localDateTime："+localDateTime);
// LocalDateTime 轉 時間戳(Long) 秒級
long localDateTimeToSecond = LocalDateTime.now().toEpochSecond(ZoneOffset.ofHours(8));
System.out.println("localDateTimeToSecond："+ localDateTimeToSecond);
// LocalDateTime 轉 時間戳(Long) 毫秒級
long localDateTimeToMilliSecond = LocalDateTime.now().toInstant(ZoneOffset.ofHours(8)).toEpochMilli();
System.out.println("localDateTimeToMilliSecond："+ localDateTimeToMilliSecond);

// 時間戳(Long) 轉 LocalDate
LocalDate localDate = Instant.ofEpochMilli(timeMillis).atZone(ZoneOffset.ofHours(8)).toLocalDate();
System.out.println("localDate："+ localDate);
// LocalDate 轉 時間戳(Long) 秒級
long localDateToSecond =  LocalDate.now().atStartOfDay().toEpochSecond(ZoneOffset.ofHours(8));
System.out.println("localDateToSecond："+ localDateToSecond);
// LocalDate 轉 時間戳(Long) 毫秒級
long localDateToMilliSecond = LocalDate.now().atStartOfDay().toInstant(ZoneOffset.ofHours(8)).toEpochMilli();
System.out.println("localDateToMilliSecond："+ localDateToMilliSecond);

輸出結果為：

localDateTime：2024-03-11T19:37:02.335
localDateTime：2024-03-11T19:37:02.335
localDateTimeToSecond：1710157022
localDateTimeToMilliSecond：1710157022365
localDate：2024-03-11
localDateToSecond：1710086400
localDateToMilliSecond：1710086400000

java.time.ZoneOffset是Java8中java.time包內用來表示時區偏移量的類，它表示的是格林尼治標準時間或協調世界時間（UTC）基礎上的固定偏移量。每一個時區都可以透過一個或多個偏移量來表示，比如“+02:00”表示比UTC時間快兩個小時的時區偏移。
其例項建立有如下方式：

• ZoneOffset.ofHours(int hours)：根據小時數建立偏移量，例如 ZoneOffset.ofHours(2) 表示比UTC早2小時的時區。
• ZoneOffset.ofHoursMinutes(int hours, int minutes)：根據小時數和分鐘數建立偏移量。
• ZoneOffset.ofHoursMinutesSeconds(int hours, int minutes, int seconds)：根據小時、分鐘和秒數建立偏移量。
• ZoneOffset.ofTotalSeconds(int totalSeconds)：根據相對於UTC的總秒數建立偏移量。
• ZoneOffset.of(String offsetId)：根據偏移量ID（如 "+02:00"）建立例項。

日期時間類的操作

日期時間的增減

java.time 包中日期時間類（如 LocalDateTime、LocalDate 和 LocalTime）可以透過plusXxx() 和 minusXxx() 方法，用於對日期時間物件進行加減操作，以增加或減少指定的時間或日期單位。

1、LocalDateTime 加減：

• plusHours(int hours), plusMinutes(int minutes), plusSeconds(int seconds)：分別用於向 LocalDateTime 物件新增指定的小時數、分鐘數和秒數。
• plus(1, ChronoUnit.XXX)：這裡的 ChronoUnit 引數可以是 HOURS、MINUTES、SECONDS 等，也可以是 YEARS、MONTHS、DAYS、WEEKS 等，用於向日期時間物件新增指定單位的數量。
• plus(Duration duration)：使用 Duration 物件來增加時間，Duration 可以包含秒和納秒的精度。
• plus(Period period)：使用 Period 物件來增加日期，Period 可以表示年、月、日的數量。
• 與plusXxx() 方法相對應，minusXxx() 方法用於從日期時間物件中減少指定的單位。例如 minusHours(int hours)、minusMinutes(int minutes)、minusSeconds(int seconds) 等方法用於減少小時、分鐘、秒數。

// LocalDateTime 加減
LocalDateTime localDateTime = LocalDateTime.now();
// 以下為增加時、分、秒
LocalDateTime plusLocalDateTime = localDateTime.plusHours(1).plusMinutes(1).plusSeconds(1);
System.out.println("plusLocalDateTime："+plusLocalDateTime);
plusLocalDateTime = localDateTime.plus(1, ChronoUnit.HOURS).plus(1, ChronoUnit.MINUTES).plus(1, ChronoUnit.SECONDS);
System.out.println("plusLocalDateTime："+plusLocalDateTime);
plusLocalDateTime = localDateTime.plus(Duration.ofHours(1)).plus(Duration.of(1, ChronoUnit.MINUTES)).plus(Duration.of(1, ChronoUnit.SECONDS));
System.out.println("plusLocalDateTime："+plusLocalDateTime);

// 以下為增加年、月、日
plusLocalDateTime = localDateTime.plusYears(1).plusMonths(1).plusWeeks(1).plusDays(1);
System.out.println("plusLocalDateTime："+plusLocalDateTime);
plusLocalDateTime = localDateTime.plus(1, ChronoUnit.YEARS).plus(1, ChronoUnit.MONTHS).plus(1, ChronoUnit.WEEKS).plus(1, ChronoUnit.DAYS);
System.out.println("plusLocalDateTime："+plusLocalDateTime);
plusLocalDateTime = localDateTime.plus(Duration.of(1, ChronoUnit.YEARS)).plus(Duration.of(1, ChronoUnit.MONTHS)).plus(Duration.of(1, ChronoUnit.WEEKS)).plus(Duration.ofDays(1));
System.out.println("plusLocalDateTime："+plusLocalDateTime);
plusLocalDateTime = localDateTime.plus(Period.ofYears(1)).plus(Period.ofMonths(1)).plus(Period.ofWeeks(1)).plus(Period.ofDays(1));
System.out.println("plusLocalDateTime："+plusLocalDateTime);

// 以下為減少時、分、秒
LocalDateTime minusLocalDateTime = localDateTime.minusHours(1).minusMinutes(1).minusSeconds(1);
System.out.println("minusLocalDateTime："+minusLocalDateTime);
minusLocalDateTime = localDateTime.minus(1, ChronoUnit.HOURS).minus(1, ChronoUnit.MINUTES).minus(1, ChronoUnit.SECONDS);
System.out.println("minusLocalDateTime："+minusLocalDateTime);
minusLocalDateTime = localDateTime.minus(Duration.ofHours(1)).minus(Duration.of(1, ChronoUnit.MINUTES)).minus(Duration.of(1, ChronoUnit.SECONDS));
System.out.println("minusLocalDateTime："+minusLocalDateTime);

// 以下為減少年、月、日
minusLocalDateTime = localDateTime.minusYears(1).minusMonths(1).minusWeeks(1).minusDays(1);
System.out.println("minusLocalDateTime："+minusLocalDateTime);
minusLocalDateTime = localDateTime.minus(1, ChronoUnit.YEARS).minus(1, ChronoUnit.MONTHS).minus(1, ChronoUnit.WEEKS).minus(1, ChronoUnit.DAYS);
System.out.println("minusLocalDateTime："+minusLocalDateTime);
minusLocalDateTime = localDateTime.minus(Duration.of(1, ChronoUnit.YEARS)).minus(Duration.of(1, ChronoUnit.MONTHS)).minus(Duration.of(1, ChronoUnit.WEEKS)).minus(Duration.ofDays(1));
System.out.println("minusLocalDateTime："+minusLocalDateTime);
minusLocalDateTime = localDateTime.minus(Period.ofYears(1)).minus(Period.ofMonths(1)).minus(Period.ofWeeks(1)).minus(Period.ofDays(1));
System.out.println("plusLocalDateTime："+minusLocalDateTime);

2、LocalDate 加減：

• 同樣的，plusYears(int years), plusMonths(int months), plusDays(int days) 分別用於增加年、月、日。
• plus(1, ChronoUnit.XXX)和plus(Duration/Period duration/period) 方法在此同樣適用，用於增加指定的日期單位。
• 與plusXxx() 方法相對應，minusXxx() 方法用於從日期時間物件中減少指定的單位。例如 minusYears(int years)、minusMonths(int months)、minusWeeks(int weeks)、minusDays(int days) 等方法用於減少年、月、周、天數。

// LocalDate 加減
LocalDate localDate = LocalDate.now();
LocalDate plusLocalDate = localDate.plusYears(1).plusMonths(1).plusWeeks(1).plusDays(1);
System.out.println("plusLocalDate："+plusLocalDate);
plusLocalDate = localDate.plus(1, ChronoUnit.YEARS).plus(1, ChronoUnit.MONTHS).plus(1, ChronoUnit.WEEKS).plus(1, ChronoUnit.DAYS);
System.out.println("plusLocalDate："+plusLocalDate);
plusLocalDate = localDate.plus(Duration.of(1, ChronoUnit.YEARS)).plus(Duration.of(1, ChronoUnit.MONTHS)).plus(Duration.of(1, ChronoUnit.WEEKS)).plus(Duration.ofDays(1));
System.out.println("plusLocalDate："+plusLocalDate);
plusLocalDate = localDate.plus(Period.ofYears(1)).plus(Period.ofMonths(1)).plus(Period.ofWeeks(1)).plus(Period.ofDays(1));
System.out.println("plusLocalDate："+plusLocalDate);

LocalDate minusLocalDate = localDate.minusYears(1).minusMonths(1).minusWeeks(1).minusDays(1);
System.out.println("minusLocalDate："+minusLocalDate);
minusLocalDate = localDate.minus(1, ChronoUnit.YEARS).minus(1, ChronoUnit.MONTHS).minus(1, ChronoUnit.WEEKS).minus(1, ChronoUnit.DAYS);
System.out.println("minusLocalDate："+minusLocalDate);
minusLocalDate = localDate.minus(Duration.of(1, ChronoUnit.YEARS)).minus(Duration.of(1, ChronoUnit.MONTHS)).minus(Duration.of(1, ChronoUnit.WEEKS)).minus(Duration.ofDays(1));
System.out.println("minusLocalDate："+minusLocalDate);
minusLocalDate = localDate.minus(Period.ofYears(1)).minus(Period.ofMonths(1)).minus(Period.ofWeeks(1)).minus(Period.ofDays(1));
System.out.println("minusLocalDate："+minusLocalDate);

3、LocalTime 加減：

• plusHours(int hours), plusMinutes(int minutes), plusSeconds(int seconds)：分別用於向 LocalTime 物件新增指定的小時數、分鐘數和秒數。
• 同樣支援 plus(1, ChronoUnit.XXX) 和 plus(Duration duration) 方法，用於增加時間單位。
• 與 plusXxx() 方法相對應，minusXxx() 方法用於從日期時間物件中減少指定的單位。minus(1, ChronoUnit.XXX), minus(Duration duration), minus(Period period) 方法也分別用於減少指定的日期或時間單位。例如 minusHours(int hours)、minusMinutes(int minutes)、minusSeconds(int seconds) 等方法用於減少小時、分鐘、秒數。

// LocalTime 加減
LocalTime localTime = LocalTime.now();
LocalTime plusLocalTime = localTime.plusHours(1).plusMinutes(1).plusSeconds(1);
System.out.println("plusLocalTime："+plusLocalTime);
plusLocalTime = localTime.plus(1, ChronoUnit.HOURS).plus(1, ChronoUnit.MINUTES).plus(1, ChronoUnit.SECONDS);
System.out.println("plusLocalTime："+plusLocalTime);
plusLocalTime = localTime.plus(Duration.ofHours(1)).plus(Duration.of(1, ChronoUnit.MINUTES)).plus(Duration.of(1, ChronoUnit.SECONDS));
System.out.println("plusLocalTime："+plusLocalTime);

LocalTime minusLocalTime = localTime.minusHours(1).minusMinutes(1).minusSeconds(1);
System.out.println("minusLocalTime："+minusLocalTime);
minusLocalTime = localTime.minus(1, ChronoUnit.HOURS).minus(1, ChronoUnit.MINUTES).minus(1, ChronoUnit.SECONDS);
System.out.println("minusLocalDateTime："+minusLocalTime);
minusLocalTime = localTime.minus(Duration.ofHours(1)).minus(Duration.of(1, ChronoUnit.MINUTES)).minus(Duration.of(1, ChronoUnit.SECONDS));
System.out.println("minusLocalDateTime："+minusLocalTime);

日期時間修改指定值

LocalDate、LocalTime、LocalDateTime、ZonedDateTime可以透過相對應的withXxx()方法修改指定的值。

1、LocalDate：

• LocalDate.withYear(int year)：修改年份欄位。
• LocalDate.withMonth(int month)：修改月份欄位（注意月份是從1開始計數的）。
• LocalDate.withDayOfMonth(int dayOfMonth)：修改日期欄位。

LocalDate localDate = LocalDate.of(2024, 3, 12);
LocalDate newDate = localDate.withYear(2025).withMonth(4).with(ChronoField.DAY_OF_MONTH, 13);
System.out.println("newDate："+newDate);

2、LocalTime：

• LocalTime.withHour(int hour)：修改小時欄位。
• LocalTime.withMinute(int minute)：修改分鐘欄位。
• LocalTime.withSecond(int second)：修改秒欄位。
• LocalTime.withNano(int nanoOfSecond)：修改納秒欄位。

LocalTime localTime = LocalTime.of(17, 25, 30);
LocalTime newTime = localTime.withHour(18).withMinute(26).with(ChronoField.SECOND_OF_MINUTE, 31);
System.out.println("newTime："+newTime);

3、LocalDateTime：

• LocalDateTime.withYear(int year)
• LocalDateTime.withMonth(int month)
• LocalDateTime.withDayOfMonth(int dayOfMonth)
• LocalDateTime.withHour(int hour)
• LocalDateTime.withMinute(int minute)
• LocalDateTime.withSecond(int second)
• LocalDateTime.withNano(int nanoOfSecond)

LocalDateTime localDateTime = LocalDateTime.of(2024, 3, 12, 17, 25, 30);
LocalDateTime newDateTime = localDateTime.withYear(2025).withMonth(4).with(ChronoField.DAY_OF_MONTH, 13).withHour(18).withMinute(26).with(ChronoField.SECOND_OF_MINUTE, 31);
System.out.println("newDateTime："+ newDateTime);

4、ZonedDateTime：

• 除了上述的日期和時間欄位外，還有時區相關的 withZoneSameInstant(ZoneId zone) 方法，可以改變時區的同時保持同一瞬間不變。

ZonedDateTime zonedDateTime = ZonedDateTime.of(2024, 3, 12, 17, 25, 30, 0, ZoneId.of("Europe/London"));
ZonedDateTime newZonedDateTime = zonedDateTime.withZoneSameInstant(ZoneId.of("America/New_York"));
System.out.println("newZonedDateTime："+ newZonedDateTime);

除此之外，調整日期時間還可以透過TemporalAdjusters，TemporalAdjuster 是一個函式式介面，用於根據給定的規則調整日期時間物件。Java8的 java.time.temporal 包中預定義了一系列常用的 TemporalAdjuster 實現，例如獲取下一個工作日、月初、月末等。

LocalDate date = LocalDate.of(2024, 3, 11);
// 下一個工作日
LocalDate nextWorkingDay = date.with(TemporalAdjusters.next(DayOfWeek.MONDAY)); // 如果11號不是週一，則返回下一個週一的日期
// 下一個月的第一天
LocalDate firstDayNextMonth = date.with(TemporalAdjusters.firstDayOfMonth()); // 返回4月1日
// 當月的最後一個工作日
LocalDate lastWorkingDay = date.with(TemporalAdjusters.lastInMonth(DayOfWeek.FRIDAY)); // 返回3月最後一個週五的日期

// 自定義 TemporalAdjuster
TemporalAdjuster adjuster = temporal -> {
    return temporal.plusDays(10).with(TemporalAdjusters.lastDayOfMonth());
};
LocalDate tenthDayNextMonthEnd = date.with(adjuster); // 返回4月最後一個日期，前提是先加10天

日期時間的比較

在Java8及其以後版本的日期時間API中，isBefore() 和 isAfter() 方法是 java.time 包中的 LocalDate、LocalTime、LocalDateTime、ZonedDateTime 等日期時間類所共有的方法，用於比較兩個日期時間物件的先後順序。

isBefore()：

• 此方法用於判斷當前物件是否早於另一個日期時間物件。
• 如果當前物件的時間點在引數物件之前，則返回 true；否則返回 false。

LocalDate date1 = LocalDate.of(2024, 3, 11);
LocalDate date2 = LocalDate.of(2024, 3, 12);
boolean isEarlier = date1.isBefore(date2); // 返回 true，因為 date1 在 date2 之前

isAfter()：

• 此方法用於判斷當前物件是否晚於另一個日期時間物件。
• 如果當前物件的時間點在引數物件之後，則返回 true；否則返回 false。

LocalDateTime time1 = LocalDateTime.of(2024, 3, 11, 10, 0);
LocalDateTime time2 = LocalDateTime.of(2024, 3, 11, 9, 0);
boolean isLater = time1.isAfter(time2); // 返回 true，因為 time1 在 time2 之後

compareTo()
在Java 8的 java.time 包中，大部分日期時間類如 LocalDate、LocalTime、LocalDateTime、ZonedDateTime 都實現了 Comparable 介面，從而可以直接使用 compareTo() 方法進行比較。compareTo() 方法用於比較兩個日期時間物件的先後順序，返回值含義如下：

• 如果當前物件早於（時間點在前）引數物件，返回負數。
• 如果當前物件等於引數物件，返回0。
• 如果當前物件晚於（時間點在後）引數物件，返回正數。

LocalDate date1 = LocalDate.of(2024, 3, 11);
LocalDate date2 = LocalDate.of(2024, 3, 12);

int comparisonResult = date1.compareTo(date2);

if (comparisonResult < 0) {
    System.out.println("date1 is before date2");
} else if (comparisonResult > 0) {
    System.out.println("date1 is after date2");
} else {
    System.out.println("date1 is equal to date2");
}

LocalDateTime dateTime1 = LocalDateTime.of(2024, 3, 11, 10, 30);
LocalDateTime dateTime2 = LocalDateTime.of(2024, 3, 11, 11, 00);

int timeComparisonResult = dateTime1.compareTo(dateTime2);

其他操作

在Java8的 java.time 包中，各個日期時間類如 LocalDate、LocalTime、LocalDateTime 提供了一系列 get 方法，用於獲取特定欄位的值。

獲取日期中的特定欄位：

LocalDate date = LocalDate.of(2024, 3, 11);
int dayOfMonth = date.getDayOfMonth(); // 獲取當月的第幾天，此處返回11
int monthValue = date.getMonthValue(); // 獲取月份值，此處返回3
Month month = date.getMonth(); // 獲取Month列舉，此處返回March
int year = date.getYear(); // 獲取年份，此處返回2024

對於時間部分，類似地可以獲取小時、分鐘、秒和納秒：

LocalTime time = LocalTime.of(19, 30, 45);
int hour = time.getHour(); // 獲取小時數，此處返回10
int minute = time.getMinute(); // 獲取分鐘數，此處返回30
int second = time.getSecond(); // 獲取秒數，此處返回45
int nano = time.getNano(); // 獲取納秒數

在SpringBoot中使用

SpringBoot預設整合了Jackson作為JSON處理庫，Jackson已經能自動處理 LocalDate、LocalTime 和 LocalDateTime 型別。

如果需要使用自定義日期時間格式，我們有兩種方式：

手動更改全域性配置： 如果需要自定義日期格式，可以透過 ObjectMapper 的配置類來註冊自定義的日期格式化器：

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-json</artifactId>
</dependency>

@Configuration
public class JacksonConfig {
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer() {
        return builder -> {
            builder.simpleDateFormat("yyyy-MM-dd");
            // 使用Java 8時間API的日期格式器
            builder.dateFormat(new StdDateFormat().withColonInTimeZone(true));
            // 註冊LocalDateTime的序列化和反序列化模組
            builder.modules(new JavaTimeModule());
        };
    }
}

手動繫結格式化配置
SpringBoot支援自動繫結HTTP請求引數到控制器方法引數中，包括 LocalDate、LocalTime 和 LocalDateTime 型別。客戶端需傳送符合日期格式的字串，Spring Boot會自動轉換成相應型別。

@PostMapping("/events")
    public ResponseEntity<Event> createEvent(@RequestParam @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate date,
                                             @RequestParam @DateTimeFormat(pattern = "HH:mm:ss") LocalTime startTime,
                                             @RequestParam @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime timestamp) {
        // ...
    }

或者請求或者響應VO中：

 public static class ResponseVO{

		@DateTimeFormat(pattern = "yyyy-MM-dd")
		private  LocalDate date;
		
		@DateTimeFormat(pattern = "HH:mm:ss") 
		private LocalTime startTime;
		
		@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
		private  LocalDateTime timestamp;
    }

Mybatis中使用

在MyBatis中查詢MySQL資料庫時，使用Java 8的 java.time.LocalDate、java.time.LocalTime 和 java.time.LocalDateTime型別。

1. 資料庫表結構： 在MySQL資料庫中，通常需要使用適合的日期時間型別來儲存這些Java 8的日期時間物件。例如：
   • LocalDate 對應MySQL的DATE型別。
   • LocalTime 對應MySQL 的 TIME 型別。
   • LocalDateTime 對應MySQL的 DATETIME或TIMESTAMP型別。

CREATE TABLE `test_date`(
    `id` BIGINT ( 20 ) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '自增主鍵',
    test_local_date DATE ,
    test_local_time TIME,
    test_local_date_time DATETIME,
    PRIMARY KEY ( `id` )
)
ENGINE = INNODB AUTO_INCREMENT = 1 DEFAULT CHARSET = utf8mb4 COMMENT = '日期時間測試';

2. 實體類對映： 在Java實體類中，對應欄位應宣告為 LocalDate、LocalTime 或 LocalDateTime 型別。

@Data
public class TestDate implements Serializable {
    /**
    * 自增主鍵
    */
    private Long id;

    private LocalDate testLocalDate;

    private LocalTime testLocalTime;

    private LocalDateTime testLocalDateTime;

    private static final long serialVersionUID = 1L;
}

3.MyBatis配置：

• 自動型別轉換：如果你使用的是較新的MyBatis版本（>=3.4.5），MyBatis已經內建了對Java 8日期時間型別的處理。這意味著在執行SQL查詢時，MyBatis會自動將資料庫中的日期時間欄位轉換為相應的Java8型別。

@Test
public void testInsertDate(){
	TestDate testDate = new TestDate();
	testDate.setTestLocalDate(LocalDate.of(2024, 3, 12));
	testDate.setTestLocalTime(LocalTime.of(20,10,30));
	testDate.setTestLocalDateTime(LocalDateTime.of(2024, 3, 12,20,10,30,0));
	testDateMapper.insert(testDate);
}

@Test
public void testQueryDate(){
	TestDate testDate = testDateMapper.selectByPrimaryKey(1L);
	System.out.println("testLocalDate:"+testDate.getTestLocalDate());
	System.out.println("testLocalTime:"+testDate.getTestLocalTime());
	System.out.println("testLocalDateTime:"+testDate.getTestLocalDateTime());
}

• 自定義TypeHandler：如果MyBatis版本較低或者需要自定義日期時間格式，你可能需要自定義 TypeHandler 來處理 LocalDate、LocalTime 和 LocalDateTime 與資料庫欄位間的轉換。關於Mybatis使用自定義TypeHandler，請非同步：玩轉Mybatis：自定義TypeHandler，輕鬆應對Mysql的JSON型別操作

結論

綜上所述，本文深入探討了Java 8引入的全新日期時間API相較於傳統的Date和Calendar類的優勢及實際應用。鑑於Java 8新日期時間API在設計上的先進性和易用性，我們強烈建議開發者積極採納並替換掉陳舊的Date和Calendar類，轉而採用如LocalDate、LocalDateTime、ZonedDateTime等現代日期時間類。

Java 8新日期時間API提供了更為清晰、直觀的操作介面，支援不可變物件設計模式，增強了型別安全性，並具備豐富的日期時間運算、解析與格式化功能，顯著提高了程式碼質量與可讀性。此外，新API對日期時間單位的精確度控制、時區管理以及與其他日期時間規範的相容性等方面均表現出卓越的表現力和靈活性，使得開發者在處理各類複雜日期時間邏輯時能夠更加得心應手，提升開發效率。

因此，無論是處於對程式碼現代化改造的需求，還是出於提高開發效率和程式穩定性的考量，遷移到Java 8的新日期時間API無疑是明智之舉。透過充分利用這些強大且功能完備的工具，開發者將在日期時間處理領域實現飛躍，為專案的長期維護和發展打下堅實基礎。

本文已收錄於我的個人部落格：碼農Academy的部落格，專注分享Java技術乾貨，包括Java基礎、Spring Boot、Spring Cloud、Mysql、Redis、Elasticsearch、中介軟體、架構設計、面試題、程式設計師攻略等