## 前言

在日常開發中，我們經常會使用到一些有關日期相關的資料操作，比如：獲取日期對應周幾、獲取一個月中存在等獲取時間的操作。

而在 Java 8 之前的日期 API 設計是非常反人類的。使用 `new Date()` 建立的時間，獲取年份的時候，是透過從1900開始1計算，而且獲取的月份0代表1月份。並且使用時無法保證執行緒安全，多個執行緒操作時，可能會出問題。

到了 Java 8 將時間的 API 進行重新的設計，明確分離，它為日期（`Date`）、時間（`Time`）、日期時間（`DateTime`）、時間戳（`unix timestamp`）以及時區定義了不同的類，而且所有類是不可變的，保證了使用中執行緒安全問題。

本文將對開發中常用的案例，進行講解，方便大家高效開發。

## 核心類

Java 8 日期時間的預設格式如下：`yyyy-MM-dd-HH-mm-ss.zzz`

幾個主要的核心類：

- `LocalDate`：表示日期類，不包含時間時分秒
- `LocalTime`：表示時間類，不包含日期月日年
- `LocalDateTime`：表示日期和時間類
- `ZonedDateTime`：表示時區日期時間類
- `OffsetDateTime`：表示按 UTC 時間偏移來得到日期時間
- `Clock`：表示獲取某個時區下當前的瞬時時間，日期或者時間
- `Instant`：表示Unix時間，代表時間戳，比如`2018-01-14T02:20:13.592Z`
- `Duration`：表示兩個時間之間，表示一個絕對的精確跨度，使用毫秒為單位
- `Period`：表示兩個日期之間
- `ZoneId`：表示時區
- `DateTimeFormatter`：表示格式化輸出
- `TemporalAdjusters`：表示獲得指定日期時間等，如當月的第一天、今年的最後一天等等

## 常用案例

#### 獲取今日的日期

使用 `LocalDate` 物件的 `now()` 可以直接拿到今日的日期。然後透過 `DateTimeFormatter` 可以對日期進行格式化列印。

```
LocalDate localDate = LocalDate.now();
System.out.println("今天日期是:"+localDate);
DateTimeFormatter fmtDate = DateTimeFormatter.ofPattern("yyyyMMdd");
System.out.println("今天日期格式化:"+localDate.format(fmtDate));

/**
 * -------- 列印 --------
 * 今天日期是:2021-11-12
 * 今天日期格式化:20211112
 */
```

#### 獲取日期中的年月日

```
LocalDate localDate = LocalDate.now();
int year = localDate.getYear();
int month = localDate.getMonthValue();
int day = localDate.getDayOfMonth();
System.out.println("年:"+year);
System.out.println("月:"+month);
System.out.println("日:"+day);

/**
 * -------- 列印 --------
 *年:2021
 *月:11
 *日:12
 */
```

#### 比較不同日期

`LocalDate` 物件可以透過 `equals()` / `isAfter()` / `isBefore()` 方法對日期進行比較，非常方便。

```
LocalDate localDate = LocalDate.now();
LocalDate localDateOther = LocalDate.of(2021,11,11);
System.out.println("localDate 等於 localDateOther："+localDate.equals(localDateOther));
System.out.println("localDate 大於 localDateOther："+localDate.isAfter(localDateOther));
System.out.println("localDate 小於 localDateOther："+localDate.isBefore(localDateOther));

/**
 * -------- 列印 --------
 *localDate 等於 localDateOther：false
 *localDate 大於 localDateOther：true
 *localDate 小於 localDateOther：false
 */
```

#### 獲取當前時間

使用 `LocalTime` 物件的 `now()` 可以直接拿到今日的時間，不包含日期。

```
LocalTime nowTime = LocalTime.now();
System.out.println("當前時間為:"+nowTime);

/**
 * -------- 列印 --------
 *當前時間為:12:56:17.908
 */
```

#### 日期時間的計算

使用 `LocalTime` 物件的 `now()` 可以直接拿到今日的時間，不包含日期。

```
LocalDate localDate = LocalDate.of(2021,11,11);
LocalTime nowTime = LocalTime.now();
LocalDate tempDate;
LocalTime tempTime;

tempDate = localDate.with(TemporalAdjusters.previous(DayOfWeek.MONDAY)).minusDays(7);
System.out.println("今年雙11上週週一是:"+tempDate);

DayOfWeek dayOfWeek = localDate.getDayOfWeek();
System.out.println("今年雙11是周幾？:"+dayOfWeek);

tempTime = nowTime.plusHours(5).plusMinutes(20);
System.out.println("五小時20分鐘後是:"+tempTime);

tempTime = nowTime.minusHours(3);
System.out.println("3小時前是:"+tempTime);

/**
 * -------- 列印 --------
 *今年雙11上週週一是:2021-11-01
 *今年雙11是周幾？:THURSDAY
 *五小時20分鐘後是:18:28:44.508
 *3小時前是:10:08:44.508
 */
```

#### 計算兩個日期之間的間隔

使用 `LocalTime` 物件的 `now()` 可以直接拿到今日的時間，不包含日期。

```
LocalDate localDate = LocalDate.of(2019,5,1);
LocalDate localDateOther = LocalDate.of(2021,11,11);
Period period = Period.between(localDate, localDateOther);
System.out.println("Years:" + period.getYears() +" months:" + period.getMonths() +" days:"+period.getDays());

/**
 * -------- 列印 --------
 *Years:2 months:6 days:10
 */
```

## 總結

透過 `LocalDate`、`LocalTime` 的使用，可以對於常見的業務場景的時間日期進行高效的計算，更多還是自己去動手去實踐吧。

【語言】Java 日期 API 的使用技巧

相關文章