LocalDate，LocalTime和LocalDateTime

以下內容全部是本人抄錄自https://mp.weixin.qq.com/s/FNsyV4skO4NauynR2igp5A

此次抄錄是為了方便自己以后查找——不涉及商業用途，感覺作者寫的比較全面和規整，所以直接拿過來做備份了，希望大家支持原作者，查看原鏈接

1.概述

Java 8為Date和Time引入了新的API，以解決舊java.util.Date和java.util.Calendar的缺點。

作為本文的一部分，讓我們從現有Date和Calendar API存在的一些問題入手，來探討新的Java 8 Date和Time API如何解決這些問題。

我們還將搞一搞Java 8時間類庫中的核心類，比如LocalDate, LocalTime, LocalDateTime, ZonedDateTime, Period, Duration以及它們的api。

2. 舊的時間API（java8之前）的問題

• 線程安全 - Date 和Calendar類不是線程安全的，使開發者難以調試這些api的並發問題，需要編寫額外的代碼來處理線程安全。Java 8中引入的新的Date和Time API是不可變的和線程安全的，使得這些痛點得以解決。

• API設計和易於理解 - 舊的時間api非常難以理解，操作都非常復雜，非常繞口，沒有提供一些常用的解析轉換方法。新的時間API是以ISO為中心的，並遵循 date, time, duration 和 periods的一致域模型。提供了一些非常實用方法以支持最常見的操作。不再需要我們自己封裝一些時間操作類。

• ZonedDate和Time - 在舊的時間api中開發人員必須編寫額外的邏輯來處理舊API的時區邏輯，而使用新的API，可以使用 Local和ZonedDate / Time API來處理時區。無需過多關心時區轉換問題。

3. 使用LocalDate，LocalTime和LocalDateTime

最常用的類是LocalDate，LocalTime和LocalDateTime。正如他們的名字所示，它們代表與上下文相結合的本地日期/時間。

這些類主要用於不需要在上下文中明確指定時區的情況。作為本節的一部分，我們將介紹最常用的API。

3.1。使用LocalDate

LocalDate表示在ISO格式（YYYY-MM-DD）下的不帶具體時間的日期。

常用於表示生日或者我們最關心的發工資的日期。

獲取當前系統時鍾下的日期，如下所示：

LocalDate localDate = LocalDate.now();

 

表示特定日，月和年的LocalDate可以使用“ of ”方法或使用“ parse ”方法獲得。例如，以下代碼段代表2015年2月20日的LocalDate：

LocalDate.of(2015, 02, 20);
LocalDate.parse("2015-02-20");

 

是不是非常直觀而且方便呢！LocalDate提供各種實用方法，以獲得各種日期信息。讓我們快速瀏覽一下這些API方法。

以下代碼段獲取當前本地日期並添加一天：

LocalDate tomorrow = LocalDate.now().plusDays(1);

 

此示例獲取當前日期並減去一個月。請注意它是如何接受枚舉作為時間單位的：

LocalDate previousMonthSameDay = LocalDate.now().minus(1, ChronoUnit.MONTHS);

 

在以下兩個代碼示例中，我們分析日期“2016-06-12”並分別獲取星期幾和月中的某天。注意返回值，第一個是表示DayOfWeek的對象，而第二個是表示月份的序數值的int：

DayOfWeek sunday = LocalDate.parse("2016-06-12").getDayOfWeek();
int twelve = LocalDate.parse("2016-06-12").getDayOfMonth();

 

我們可以測試一個日期是否發生在閏年，如果用老方法怕不是要上天：

boolean leapYear = LocalDate.now().isLeapYear();

 

判斷日期的先后：

boolean notBefore = LocalDate.parse("2016-06-12").isBefore(LocalDate.parse("2016-06-11"));
boolean isAfter = LocalDate.parse("2016-06-12").isAfter(LocalDate.parse("2016-06-11"));

 

日期邊界可以從給定日期獲得。在以下兩個示例中，我們得到LocalDateTime，它代表給定日期的一天的開始（2016-06-12T00：00）和代表月初的LocalDate（2016-06-01）：

LocalDateTime beginningOfDay = LocalDate.parse("2016-06-12").atStartOfDay();
LocalDate firstDayOfMonth = LocalDate.parse("2016-06-12")
 .with(TemporalAdjusters.firstDayOfMonth());

 

現在讓我們來看看我們如何使用當地時間。

3.2。使用LocalTime

在本地時間表示不帶日期的時間。

與LocalDate類似，可以從系統時鍾或使用“parse”和“of”方法創建LocalTime實例。快速瀏覽下面的一些常用API。

可以從系統時鍾創建當前LocalTime的實例，如下所示：

LocalTime now = LocalTime.now();

 

在下面的代碼示例中，我們通過解析字符串表示創建表示06:30 AM 的LocalTime：

LocalTime sixThirty = LocalTime.parse("06:30");

 

方法“of”可用於創建LocalTime。例如，下面的代碼使用“of”方法創建表示06:30 AM的LocalTime：

LocalTime sixThirty = LocalTime.of(6, 30);

 

下面的示例通過解析字符串來創建LocalTime，並使用“plus”API為其添加一小時。結果將是代表07:30 AM的LocalTime：

LocalTime sevenThirty = LocalTime.parse("06:30").plus(1, ChronoUnit.HOURS);

 

各種getter方法可用於獲取特定的時間單位，如小時，分鍾和秒，如下所示獲取小時：

int six = LocalTime.parse("06:30").getHour();

 

同LocalDate一樣檢查特定時間是否在另一特定時間之前或之后。下面的代碼示例比較結果為true的兩個LocalTime：

boolean isbefore = LocalTime.parse("06:30").isBefore(LocalTime.parse("07:30"));

 

一天中的最大，最小和中午時間可以通過LocalTime類中的常量獲得。在執行數據庫查詢以查找給定時間范圍內的記錄時，這非常有用。例如，下面的代碼代表23：59：59.99：

LocalTime maxTime = LocalTime.MAX

 

現在讓我們深入了解LocalDateTime。

3.3。使用LocalDateTime

所述LocalDateTime用於表示日期和時間的組合。

當我們需要結合日期和時間時，這是最常用的類。該類提供了各種API，我們將介紹一些最常用的API。

類似於LocalDate和LocalTime從系統時鍾獲取LocalDateTime的實例：

LocalDateTime.now();

 

下面的代碼示例解釋了如何使用工廠“of”和“parse”方法創建實例。結果將是代表2015年2月20日06:30 AM 的LocalDateTime實例：

LocalDateTime.of(2015, Month.FEBRUARY, 20, 06, 30);
LocalDateTime.parse("2015-02-20T06:30:00");

 

有一些實用的API可以支持特定時間單位的時間運算，例如天，月，年和分鍾。以下代碼示例演示了“加”和“減”方法的用法。這些API的行為與LocalDate和LocalTime中的 API完全相同：

localDateTime.plusDays(1);
localDateTime.minusHours(2);

 

Getter方法可用於提取類似於日期和時間類的特定單位。鑒於上面的LocalDateTime實例，下面的代碼示例將返回2月份的月份：

localDateTime.getMonth();

 

4. 使用ZonedDateTime API

當我們需要處理時區特定的日期和時間時，Java 8提供了ZonedDateTime 類。ZoneID是用於表示不同區域的標識符。大約有40個不同的時區，使用ZoneID表示它們，如下所示

下面的代碼我們來獲取下“亞洲/上海”時區:

ZoneId zoneId = ZoneId.of("Aisa/Shanghai");

 

獲取所有的時區：

Set<String> allZoneIds = ZoneId.getAvailableZoneIds();

 

LocalDateTime轉化為特定的時區中的時間：

ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, zoneId);

 

ZonedDateTime提供解析方法來獲取時區的特定日期時間：

ZonedDateTime.parse("2015-05-03T10:15:30+01:00[Aisa/Shanghai]");

 

使用時區的另一種方法是使用OffsetDateTime。OffsetDateTime是具有偏移量的日期時間的不可變表示形式。此類存儲所有日期和時間字段，精確到納秒，以及從UTC/格林威治的偏移量。可以使用ZoneOffset創建OffsetDateTime實例。這里我們創建一個LocalDateTime來表示2015年2月20日上午6:30：

LocalDateTime localDateTime = LocalDateTime.of(2015, Month.FEBRUARY, 20, 06, 30);

 

然后我們通過創建ZoneOffset並為LocalDateTime實例設置來增加兩個小時：

ZoneOffset offset = ZoneOffset.of("+02:00");
OffsetDateTime offSetByTwo = OffsetDateTime.of(localDateTime, offset);

 

我們現在的本地日期時間為2015-02-20 06:30 +02：00。現在讓我們繼續討論如何使用Period和Duration類修改日期和時間值。

5.使用Period和Duration

• Period : 用於計算兩個日期（年月日）間隔。

• Duration : 用於計算兩個時間（秒，納秒）間隔。

5.1。使用Period

Period 類被廣泛地用於修改給定的日期的值或者獲取兩個日期之間的差值：

LocalDate initialDate = LocalDate.parse("2007-05-10");
LocalDate finalDate = initialDate.plus(Period.ofDays(5));

 

Period 類有各種getter方法，如getYears，getMonths和getDays從獲取值周期對象。下面的代碼示例返回一個int值為5，是基於上面示例的逆序操作：

int five = Period.between(finalDate, initialDate).getDays();

 

該Period 可以在特定的單元獲得兩個日期之間的如天或月或數年，使用ChronoUnit.between：

int five = ChronoUnit.DAYS.between(finalDate , initialDate);

 

此代碼示例返回五天。讓我們繼續看看Duration類。

5.2。使用Duration

類似Period ，該Duration類是用來處理時間。在下面的代碼中，我們創建一個本地時間上午6:30，然后加30秒的持續時間，以使本地時間上午6時三十〇分30秒的：

LocalTime initialTime = LocalTime.of(6, 30, 0);
LocalTime finalTime = initialTime.plus(Duration.ofSeconds(30));

 

兩個時刻之間的持續時間可以作為持續時間或作為特定單位獲得。在第一個代碼片段中，我們使用Duration類的between（）方法來查找finalTime和initialTime之間的時間差，並以秒為單位返回差異：

int thirty = Duration.between(finalTime, initialTime).getSeconds();

 

在第二個例子中，我們使用ChronoUnit類的between（）方法來執行相同的操作：

int thirty = ChronoUnit.SECONDS.between(finalTime, initialTime);

 

現在我們來看看如何將舊的Date 和Calendar 轉換為新的Date和Time。

6.與日期和日歷的兼容性

Java 8添加了toInstant（）方法，該方法有助於將舊API中的Date和Calendar實例轉換為新的Date Time API，如下面的代碼片段所示：

LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault());
LocalDateTime.ofInstant(calendar.toInstant(), ZoneId.systemDefault());

 

所述LocalDateTime可以從如下“ofEpochSecond"方法來構造。以下代碼的結果將是代表2016-06-13T11：34：50 的LocalDateTime：

LocalDateTime.ofEpochSecond(1465817690, 0, ZoneOffset.UTC);

 

現在讓我們繼續進行日期和時間格式化。

7. 日期和時間格式化

Java 8提供了用於輕松格式化日期和時間的 API ：

LocalDateTime localDateTime = LocalDateTime.of(2015, Month.JANUARY, 25, 6, 30);

 

以下代碼傳遞ISO日期格式以格式化本地日期。結果將是2015-01-25：

String localDateString = localDateTime.format(DateTimeFormatter.ISO_DATE);

 

該DateTimeFormatter提供多種標准格式選項。也可以提供自定義模式來格式化方法，如下所示，它將返回LocalDate為2015/01/25：

localDateTime.format(DateTimeFormatter.ofPattern("yyyy/MM/dd"));

 

我們可以將格式樣式傳遞為SHORT，LONG或MEDIUM作為格式化選項的一部分。下面的代碼示例輸出2015年1月25日06:30:00 me的輸：

localDateTime
 .format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM)
 .withLocale(Locale.UK);

 

最后讓我們看看Java 8 Core Date / Time API 可用的替代方案。

8.替代方案

8.1 使用Threeten 類庫

對於從Java 7或Java 6這些老項目來說可以使用Threeten ,然后可以像在上面java 8一樣使用相同的功能，一旦你遷移到java 8 只需要修改你的包路徑代碼而無需變更：

<dependency>
    <groupId>org.threeten</groupId>
    <artifactId>threetenbp</artifactId>
    <version>LATEST</version>
</dependency>

 

8.2 Joda-Time類庫

Java 8 日期和時間庫的另一種替代方案是Joda-Time庫。事實上，Java 8 Date Time API由Joda-Time庫（Stephen Colebourne）和Oracle共同領導。該庫提供了Java 8 Date Time項目中支持的幾乎所有功能。通過在項目中引用以下pom依賴項就可以立即使用：

<dependency>
    <groupId>joda-time</groupId>
    <artifactId>joda-time</artifactId>
    <version>LATEST</version>
</dependency>