Java8新特性時間日期庫DateTime API及示例

本文轉載自查看原文 2019-10-14 15:30 352

Java8新特性的功能已經更新了不少篇幅了，今天重點講解時間日期庫中DateTime相關處理。同樣的，如果你現在依舊在項目中使用傳統Date、Calendar和SimpleDateFormat等API來處理日期相關操作，這篇文章你一定不要錯過。來刷新你的知識庫吧！

背景

Java對日期、日歷及時間的處理一直以來都飽受詬病，比如java.util.Date和java.util.Calendar類易用性差，不支持時區，非線程安全；還有用於格式化日期的類DateFormat也是非線程安全的等問題。

Java8引入的新的一系列API，對時間日期的處理提供了更好的支持，清楚的定義了時間日期的一些概念，比如說，瞬時時間（Instant）,持續時間（duration），日期（date）,時間（time），時區（time-zone）以及時間段（Period）。

同時，借鑒了Joda庫的一些優點，比如將人和機器對時間日期的理解區分開的。

簡介

新的時間日期API核心位於java.time內，另外也在java.time.chrono，java.time.format，java.time.temporal和java.time.zone有相關的API，但使用頻次較少。

Java8常用的日期和時間類包含LocalDate、LocalTime、Instant、Duration、Period、LocalDateTime以及ZonedDateTime等。

LocalDate：不包含時間的日期，比如2019-10-14。可以用來存儲生日，周年紀念日，入職日期等。
LocalTime：與LocalDate想對照，它是不包含日期的時間。
LocalDateTime：包含了日期及時間，沒有偏移信息（時區）。
ZonedDateTime：包含時區的完整的日期時間，偏移量是以UTC/格林威治時間為基准的。
Instant：時間戳，與System.currentTimeMillis()類似。
Duration：表示一個時間段。
Period：用來表示以年月日來衡量一個時間段。

另外，還有新的日期解析格式化類DateTimeFormatter。

學習最佳的途徑就是去實踐它，現在我們示例的形式來講每個知識點進行講解。

LocalDate-如何獲得日期

LocalDate類內只包含日期，不包含具體時間。只需要表示日期而不包含時間，就可以使用它。

// 只獲取日期
LocalDate today = LocalDate.now();
System.out.println(today);

int year = today.getYear(); int month = today.getMonthValue(); int day = today.getDayOfMonth(); System.out.printf("Year : %d Month : %d day : %d \t %n", year, month, day);

同時，還可以通過LocalDate獲取日期是月份的第幾天、周的第幾天，月份的天數，是否為閏年等。看下面的代碼是不是非常方便。

LocalDate today = LocalDate.now();
// 月份中的第幾天 int dayOfMonth = today.getDayOfMonth(); // 一周的第幾天 DayOfWeek dayOfWeek = today.getDayOfWeek(); // 月份的天數 int length = today.lengthOfMonth(); // 是否為閏年 boolean leapYear = today.isLeapYear();

上面通過now獲取LocalDate對象，也可以通過靜態方法of()或parse創建任意一個日期。再也不用像之前一樣年只能從1900年開始，月必須從0開始等。

LocalDate oneDay = LocalDate.of(2019,10,1); System.out.println(oneDay); LocalDate parseDay = LocalDate.parse("2019-10-01"); System.out.println(parseDay);

打印結果：2019-10-01。

LocalDate重寫了equals方法，讓日期的比較也變得簡單了。

// 定義任意日期 LocalDate oneDay = LocalDate.of(2019, 10, 1); System.out.println(oneDay); // 定義任意比較 LocalDate anyDay = LocalDate.of(2019, 10, 1); System.out.println(oneDay.equals(anyDay));

同時，針對日期還可延伸出MonthDay或YearMonth類，顧名思義，只包含月天或年月。同樣適用於equals方法來比較。

另外使用before和after可以比較兩個日期前后時間。

boolean notBefore = LocalDate.parse("2019-10-01").isBefore(LocalDate.parse("2019-10-02")); boolean isAfter = LocalDate.parse("2019-10-01").isAfter(LocalDate.parse("2019-10-02"));

對日期進行前一天后一天或前一個月的加減也變得十分方便。

LocalDate tomorrowDay = LocalDate.now().plusDays(1); LocalDate nextMonth = LocalDate.now().plusMonths(1);

還有，我們在實戰的時候往往要獲取某一天的開始時間和當天所在月的第一天等。

LocalDate.now().atStartOfDay(); LocalDate.now().with(TemporalAdjusters.firstDayOfMonth());

LocalTime-如何獲取時間

LocalTime和LocalDate類似，區別在於LocalDate不包含具體時間，而LocalTime包含具體時間。同樣可以使用now或of方法來獲得對象。

LocalTime localTime = LocalTime.now(); LocalTime oneTime = LocalTime.of(10,10,10);

LocalDate類似它也擁有parse、isBefore、獲取時間單元等方法，就不再贅述。

需要注意的是，LocalTime獲得的時間格式為：11:41:58.904。也就是，HH:mm:ss.nnn，這里nnn是納秒。

還有一個在實戰中查詢日期區間時我們經常定義的“23:59:59.99”常量再也不用自己定義了。

// 23:59:59.999999999 LocalTime maxTime = LocalTime.MAX; // 00:00 LocalTime minTime = LocalTime.MIN;

LocalDateTime-日期和時間的組合

LocalDateTime表示日期和時間組合。可以通過of()方法直接創建，也可以調用LocalDate的atTime()方法或LocalTime的atDate()方法將LocalDate或LocalTime合並成一個LocalDateTime。

創建時間示例：

LocalDateTime now = LocalDateTime.now();

LocalDateTime oneTime = LocalDateTime.of(2019,10,14,10,12,12); // 拼接日期 LocalTime.now().atDate(LocalDate.now());

LocalDateTime與LocalDate和LocalTime之間可以相互轉化。其他日期增減等操作與上面的類似。

Instant-獲取時間戳

Instant用於一個時間戳，與System.currentTimeMillis()類似，但Instant可以精確到納秒（Nano-Second）。

Instant除了可以使用now()方法創建，還可以通過ofEpochSecond方法創建。

Instant now = Instant.now(); Instant.ofEpochSecond(365 * 24 * 60, 100);

其中ofEpochSecond第一個參數表示秒，第二個參數表示納秒。整體表示：從1970-01-01 00:00:00開始后的365天100納秒的時間點。

Duration-獲取時間段

Duration的內部實現與Instant類似，但Duration表示時間段，通過between方法創建。

LocalDateTime from = LocalDateTime.now(); LocalDateTime to = LocalDateTime.now().plusDays(1); Duration duration = Duration.between(from, to); // 區間統計換算 // 總天數 long days = duration.toDays(); // 小時數 long hours = duration.toHours(); // 分鍾數 long minutes = duration.toMinutes(); // 秒數 long seconds = duration.getSeconds(); // 毫秒數 long milliSeconds = duration.toMillis(); // 納秒數 long nanoSeconds = duration.toNanos();

Duration對象還可以通過of()方法創建，該方法參數為時間段長度和時間單位。

// 7天 Duration duration1 = Duration.of(7, ChronoUnit.DAYS); // 60秒 Duration duration2 = Duration.of(60, ChronoUnit.SECONDS);

Period-獲取日期段

Period與Duration類似，獲取一個時間段，只不過單位為年月日，也可以通過of方法和between方法創建，between方法接收的參數為LocalDate。

Period period = Period.of(1, 10, 25); Period period1 = Period.between(LocalDate.now(), LocalDate.now().plusYears(1));

ZonedDateTime-創建時區時間

ZonedDateTime類，用於處理帶時區的日期和時間。ZoneId表示不同的時區。大約有40不同的時區。

獲取所有時區集合：

Set allZoneIds = ZoneId.getAvailableZoneIds();

創建時區：

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

把LocalDateTime轉換成特定的時區：

ZonedDateTime zonedDateTime = ZonedDateTime.of(LocalDateTime.now(), zoneId);

另外和時區一起使用的類是OffsetDateTime類，OffsetDateTime是不變的，表示date-time偏移，存儲所有日期和時間字段，精確至納秒，從UTC/Greenwich計算偏移。

時間日期格式化

Java8對日期的格式化操作非常簡單，首先看到上面的類大多都提供了parse方法，可以直接通過解析字符串得到對應的對象。

而日期和時間的格式化可通過LocalDateTime的format方法進行格式化。

LocalDateTime dateTime = LocalDateTime.now();
String str = dateTime.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME); System.out.println(str); str = dateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd")); System.out.println(str);

可以使用DateTimeFormatter預置的格式，也可以通過DateTimeFormatter.ofPattern方法來指定格式。