原文連線 Java8新特性系列-Date Time API

在 Java 8 中，引入了一個新的日期時間 API，以彌補舊日期時間 API 的以下缺點。

不是執行緒安全的 – java.util.Date 不是執行緒安全的，因此開發人員在使用日期時必須處理併發問題。

新的日期時間 API 是不可變的，並且沒有 setter 方法。

糟糕的設計 – 預設日期從 1900 開始，月份從 1 開始，日從 0 開始，因此沒有統一性。

舊 API 對日期操作的直接方法較少。 新的 API 為此類操作提供了許多實用方法。

時區處理困難 – 開發人員必須編寫大量程式碼來處理時區問題。 新 API 的開發考慮了特定領域的設計。

Java 8 在 java.time 包下引入了一個新的日期時間 API。 以下是 java.time 包中引入的一些重要類。

Local – 簡化的日期時間 API，沒有時區處理的複雜性。

Zoned – 處理各種時區的專用日期時間 API。

Local Date-Time API

LocalDate/LocalTime 和 LocalDateTime 類簡化了不需要時區的開發。 讓我們看看他們的行動。

import java.time.LocalDate;
import java.time.LocalTime;
import java.time.LocalDateTime;
import java.time.Month;

public class Java8Tester {

   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testLocalDateTime();
   }
	
   public void testLocalDateTime() {
      // Get the current date and time
      LocalDateTime currentTime = LocalDateTime.now();
      System.out.println("Current DateTime: " + currentTime);
		
      LocalDate date1 = currentTime.toLocalDate();
      System.out.println("date1: " + date1);
		
      Month month = currentTime.getMonth();
      int day = currentTime.getDayOfMonth();
      int seconds = currentTime.getSecond();
		
      System.out.println("Month: " + month +"day: " + day +"seconds: " + seconds);
		
      LocalDateTime date2 = currentTime.withDayOfMonth(10).withYear(2012);
      System.out.println("date2: " + date2);
		
      //12 december 2014
      LocalDate date3 = LocalDate.of(2014, Month.DECEMBER, 12);
      System.out.println("date3: " + date3);
		
      //22 hour 15 minutes
      LocalTime date4 = LocalTime.of(22, 15);
      System.out.println("date4: " + date4);
		
      //parse a string
      LocalTime date5 = LocalTime.parse("20:15:30");
      System.out.println("date5: " + date5);
   }
}
 

輸出結果

Current DateTime: 2022-02-10T21:53:59.395
date1: 2022-02-10
Month: FEBRUARYday: 10seconds: 59
date2: 2012-02-10T21:53:59.395
date3: 2014-12-12
date4: 22:15
date5: 20:15:30

Zoned Date-Time API

在考慮時區時，將使用分割槽日期時間 API。 讓我們看看他們的行動。

import java.time.ZonedDateTime;
import java.time.ZoneId;

public class Java8Tester {

   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testZonedDateTime();
   }
	
   public void testZonedDateTime() {
      // Get the current date and time
      ZonedDateTime date1 = ZonedDateTime.parse("2007-12-03T10:15:30+05:30[Asia/Karachi]");
      System.out.println("date1: " + date1);
		
      ZoneId id = ZoneId.of("Europe/Paris");
      System.out.println("ZoneId: " + id);
		
      ZoneId currentZone = ZoneId.systemDefault();
      System.out.println("CurrentZone: " + currentZone);
   }
}
 

驗證結果

date1: 2007-12-03T10:15:30+05:00[Asia/Karachi]
ZoneId: Europe/Paris
CurrentZone: Asia/Shanghai

Chrono Units Enum

Java 8 中添加了 java.time.temporal.ChronoUnit 列舉，以替換舊 API 中用於表示日、月等的整數值。讓我們看看它們的實際應用。

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class Java8Tester {

   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testChromoUnits();
   }
	
   public void testChromoUnits() {
      //Get the current date
      LocalDate today = LocalDate.now();
      System.out.println("Current date: " + today);
		
      //add 1 week to the current date
      LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
      System.out.println("Next week: " + nextWeek);
		
      //add 1 month to the current date
      LocalDate nextMonth = today.plus(1, ChronoUnit.MONTHS);
      System.out.println("Next month: " + nextMonth);
		
      //add 1 year to the current date
      LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
      System.out.println("Next year: " + nextYear);
		
      //add 10 years to the current date
      LocalDate nextDecade = today.plus(1, ChronoUnit.DECADES);
      System.out.println("Date after ten year: " + nextDecade);
   }
}

輸出結果

Current date: 2022-02-10
Next week: 2022-02-17
Next month: 2022-03-10
Next year: 2023-02-10
Date after ten year: 2032-02-10

Period and Duration

在 Java 8 中，引入了兩個專門的類來處理時間差異。

Period – 它處理基於日期的時間量。

Duration – 它處理基於時間的時間量。

讓我們看看他們的行動。

import java.time.temporal.ChronoUnit;

import java.time.LocalDate;
import java.time.LocalTime;
import java.time.Duration;
import java.time.Period;

public class Java8Tester {

   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testPeriod();
      java8tester.testDuration();
   }
	
   public void testPeriod() {
      //Get the current date
      LocalDate date1 = LocalDate.now();
      System.out.println("Current date: " + date1);
		
      //add 1 month to the current date
      LocalDate date2 = date1.plus(1, ChronoUnit.MONTHS);
      System.out.println("Next month: " + date2);
      
      Period period = Period.between(date2, date1);
      System.out.println("Period: " + period);
   }
	
   public void testDuration() {
      LocalTime time1 = LocalTime.now();
      Duration twoHours = Duration.ofHours(2);
		
      LocalTime time2 = time1.plus(twoHours);
      Duration duration = Duration.between(time1, time2);
		
      System.out.println("Duration: " + duration);
   }
}

輸出結果

Current date: 2022-02-10
Next month: 2022-03-10
Period: P-1M
Duration: PT-22H

Temporal Adjusters

TemporalAdjuster 用於執行日期數學運算。 例如，獲取“每月的第二個星期六”或“下星期二”。 讓我們看看他們的行動。

import java.time.LocalDate;
import java.time.temporal.TemporalAdjusters;
import java.time.DayOfWeek;

public class Java8Tester {

   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testAdjusters();
   }
	
   public void testAdjusters() {
      //Get the current date
      LocalDate date1 = LocalDate.now();
      System.out.println("Current date: " + date1);
		
      //get the next tuesday
      LocalDate nextTuesday = date1.with(TemporalAdjusters.next(DayOfWeek.TUESDAY));
      System.out.println("Next Tuesday on : " + nextTuesday);
		
      //get the second saturday of next month
      LocalDate firstInYear = LocalDate.of(date1.getYear(),date1.getMonth(), 1);
      LocalDate secondSaturday = firstInYear.with(TemporalAdjusters.nextOrSame(
         DayOfWeek.SATURDAY)).with(TemporalAdjusters.next(DayOfWeek.SATURDAY));
      System.out.println("Second Saturday on : " + secondSaturday);
   }
}

輸出結果

Current date: 2022-02-10
Next Tuesday on : 2022-02-15
Second Saturday on : 2022-02-12

Backward Compatibility

一個 toInstant() 方法被新增到原始的 Date 和 Calendar 物件中，可用於將它們轉換為新的 Date-Time API。 使用 ofInstant(Insant,ZoneId) 方法獲取 LocalDateTime 或 ZonedDateTime 物件。 讓我們看看他們的行動。

import java.time.LocalDateTime;
import java.time.ZonedDateTime;

import java.util.Date;

import java.time.Instant;
import java.time.ZoneId;

public class Java8Tester {

   public static void main(String args[]) {
      Java8Tester java8tester = new Java8Tester();
      java8tester.testBackwardCompatability();
   }
	
   public void testBackwardCompatability() {
      //Get the current date
      Date currentDate = new Date();
      System.out.println("Current date: " + currentDate);
		
      //Get the instant of current date in terms of milliseconds
      Instant now = currentDate.toInstant();
      ZoneId currentZone = ZoneId.systemDefault();
		
      LocalDateTime localDateTime = LocalDateTime.ofInstant(now, currentZone);
      System.out.println("Local date: " + localDateTime);
		
      ZonedDateTime zonedDateTime = ZonedDateTime.ofInstant(now, currentZone);
      System.out.println("Zoned date: " + zonedDateTime);
   }
}

輸出結果

Current date: Thu Feb 10 22:08:27 CST 2022
Local date: 2022-02-10T22:08:27.730
Zoned date: 2022-02-10T22:08:27.730+08:00[Asia/Shanghai]