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

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方法來指定格式。

關鍵點回顧

Java8中關於時間日期的API有如下關鍵點：

• 提供了javax.time.ZoneId用來處理時區。
• 提供了LocalDate與LocalTime類。
• 時間與日期API中的全部類都是線程安全的。
• 明肯定義了基本的時間與日期概念。
• 核心API：Instant、LocalDate、LocalTime、LocalDateTime、ZonedDateTime。
• DateTimeFormatter類用於在Java中進行日期的格式化與解析。

好了，關於Java8新特性的時間日期功能就將到這裏，用起來是否是簡單明快多了，趕忙在項目中練練手吧。

原文連接：《Java8新特性時間日期庫DateTime API及示例》

程序新視界：精彩和成長都不容錯過