翻譯：吳嘉俊，叩丁狼高階講師

Java8提供了一系列的關於日期和時間API的更新，在JDK中引入了基於JSR310：Date and Time API規範的Joda Time API。

新的API提供了大量關於日期和時間的優秀的功能。在本文中，我會介紹最常用的三個類：java.time.LocalDate，java.time.LocalTime和java.time.LocalDateTime。這些類不依賴於時區展示日期和時間的值，他們依賴於系統的時間去獲取日期和時間的值。

建立例項

我們先來看看使用now()方法建立這些類的例項，同時展示of()方法的使用：

jshell> LocalDate.now()
$46 ==> 2018-07-07

jshell> LocalDate.of(2018, 3, 30)
$47 ==> 2018-03-30

jshell> LocalTime.now()
$48 ==> 00:32:06.883656

jshell> LocalTime.of(12,43,12,33333);
$49 ==> 12:43:12.000033333

jshell> LocalDateTime.now()
$50 ==> 2018-07-07T00:32:30.335562400

jshell> LocalDateTime.of(2018, 12, 30, 12,33)
$51 ==> 2018-12-30T12:33

jshell> LocalDateTime.of(LocalDate.now(), LocalTime.now())
$52 ==> 2018-07-07T00:40:38.198318200
 

計算日期和時間

接下來我們看看怎麼對創建出來的日期和時間進行設定和計算：

jshell> LocalDate d = LocalDate.now()
d ==> 2018-07-07

jshell> d.plusDays(12)
$54 ==> 2018-07-19

jshell> d
d ==> 2018-07-07

jshell> d.plusMonths(2)
$56 ==> 2018-09-07

jshell> d.minusDays(5)
$57 ==> 2018-07-02

jshell> d.minusWeeks(4)
$58 ==> 2018-06-09
 

從程式碼中可以看到，這些plus*()和minus*()方法，是不會改變原date和time的例項的，返回的是新的例項。在上面的程式碼中，我們看到了幾個java.time.LocalDate提供的計算方法。同樣，在java.time.LocalTime和java.time.LocalDateTime中也有對應的plus*()和minus*()方法。

比較日期和時間

當我們想知道給定的時間或日期是在另一個時間/日期之前還是之後，我們就可以用到isBefore()和isAfter()方法，如下所示：

jshell> var d1 = LocalDate.of(2018, 7, 6)
d1 ==> 2018-07-06

jshell> var d2 = LocalDate.of(2018, 7, 7)
d2 ==> 2018-07-07

jshell> d1.isAfter(d2)
$64 ==> false

jshell> d1.isBefore(d2)
$65 ==> true

jshell> var dt1 = LocalDateTime.of(2018, 7, 7, 12, 30)
dt1 ==> 2018-07-07T12:30

jshell> var dt2 = LocalDateTime.of(2018, 7, 7, 14, 30)
dt2 ==> 2018-07-07T14:30

jshell> dt1.isBefore(dt2)
$68 ==> true

jshell> dt1.isAfter(dt2)
$69 ==> false
 

在String和日期/時間之間轉換

我們經常的一個需求就是把String型別的字串轉化成日期或者時間，同時，我們也需要把日期和時間轉變成String字串用於顯示。在以前使用java.util.Date的時候，我們一般使用java.text.SimpleDateFormat去完成日期/時間和字串的轉換，在新的日期時間API中，我們使用全新的java.time.format.DateTimeFormatter。

如果你遵循ISO標準在日期/時間和字串之間進行轉換，那麼這個事情會變得很容易，因為在java.time.format.DateTimeFormatter中，已經內建了ISO標準的格式。我們來看看程式碼：

jshell> import java.time.*

jshell> LocalDateTime ldt = LocalDateTime.now()
ldt ==> 2018-09-26T22:58:32.229096300

jshell> import java.time.format.*

jshell> ldt.format(DateTimeFormatter.ISO_DATE)
$4 ==> "2018-09-26"

jshell> ldt.format(DateTimeFormatter.ISO_DATE_TIME)
$5 ==> "2018-09-26T22:58:32.2290963"

jshell> ldt.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME)
$9 ==> "2018-09-26T22:58:32.2290963"

jshell> ldt.format(DateTimeFormatter.BASIC_ISO_DATE)
$10 ==> "20180926"

當然，我們可以使用自定義的格式來完成轉化：

jshell> ldt.format(DateTimeFormatter.ofPattern("d-M-y"));
$11 ==> "26-9-2018"

jshell> ldt.format(DateTimeFormatter.ofPattern("d-MM-y hh:mm:ss"));
$12 ==> "26-09-2018 10:58:32"

jshell> ldt.format(DateTimeFormatter.ofPattern("d/MMM/y hh:mm:ss"));
$13 ==> "26/Sep/2018 10:58:32"

jshell> ldt.format(DateTimeFormatter.ofPattern("d-MMM-y hh:mm:ss"));
$14 ==> "26-Sep-2018 10:58:32"

jshell> ldt.format(DateTimeFormatter.ofPattern("d-MMM-y hh:mm:ss"));
$15 ==> "26-Sep-2018 10:58:32"

jshell> ldt.format(DateTimeFormatter.ofPattern("d-MMM-y HH:mm:ss"));
$16 ==> "26-Sep-2018 22:58:32"

和老的API建立格式的區別在java.time.format.DateTimeFormatter文件中已經寫的很清楚了。

下面來看看，把一個合法的日期/時間格式字串轉換成一個LocalDateTime物件：

jshell> LocalDate ld = LocalDate.parse("2018-09-26")
ld ==> 2018-09-26

jshell> LocalDateTime ldt = LocalDateTime.parse("2018-09-26T22:24:33")
ldt ==> 2018-09-26T22:24:33

在上面的程式碼中我們發現，我們並沒有提供解析字串的格式，因為我們直接使用的是每個類中預設的ISO格式。這是非常簡便的解析日期/字串的方法。

至此，我簡單的介紹了關於新的日期/時間的基礎API，接下來的文章中，我們在介紹和時區相關的日期/時間API，並介紹如何在不同的日期/時間系統中進行協調使用。

原文：https://www.javacodegeeks.com/2018/10/localdate-localtime-localdatetime.html