Java8新特性的功能已經(jīng)更新了不少篇幅了,今天重點(diǎn)講解時(shí)間日期庫中DateTime相關(guān)處理。同樣的,如果你現(xiàn)在依舊在項(xiàng)目中使用傳統(tǒng)Date、Calendar和SimpleDateFormat等API來處理日期相關(guān)操作,這篇文章你一定不要錯(cuò)過。來刷新你的知識(shí)庫吧!
背景
Java對日期、日歷及時(shí)間的處理一直以來都飽受詬病,比如java.util.Date和java.util.Calendar類易用性差,不支持時(shí)區(qū),非線程安全;還有用于格式化日期的類DateFormat也是非線程安全的等問題。
Java8引入的新的一系列API,對時(shí)間日期的處理提供了更好的支持,清楚的定義了時(shí)間日期的一些概念,比如說,瞬時(shí)時(shí)間(Instant),持續(xù)時(shí)間(duration),日期(date),時(shí)間(time),時(shí)區(qū)(time-zone)以及時(shí)間段(Period)。
同時(shí),借鑒了Joda庫的一些優(yōu)點(diǎn),比如將人和機(jī)器對時(shí)間日期的理解區(qū)分開的。
簡介
新的時(shí)間日期API核心位于java.time內(nèi),另外也在java.time.chrono,java.time.format,java.time.temporal和java.time.zone有相關(guān)的API,但使用頻次較少。
Java8常用的日期和時(shí)間類包含LocalDate、LocalTime、Instant、Duration、Period、LocalDateTime以及ZonedDateTime等。
- LocalDate:不包含時(shí)間的日期,比如2019-10-14??梢杂脕泶鎯?chǔ)生日,周年紀(jì)念日,入職日期等。
- LocalTime:與LocalDate想對照,它是不包含日期的時(shí)間。
- LocalDateTime:包含了日期及時(shí)間,沒有偏移信息(時(shí)區(qū))。
- ZonedDateTime:包含時(shí)區(qū)的完整的日期時(shí)間,偏移量是以UTC/格林威治時(shí)間為基準(zhǔn)的。
- Instant:時(shí)間戳,與System.currentTimeMillis()類似。
- Duration:表示一個(gè)時(shí)間段。
- Period:用來表示以年月日來衡量一個(gè)時(shí)間段。
另外,還有新的日期解析格式化類DateTimeFormatter。
學(xué)習(xí)最佳的途徑就是去實(shí)踐它,現(xiàn)在我們示例的形式來講每個(gè)知識(shí)點(diǎn)進(jìn)行講解。
LocalDate-如何獲得日期
LocalDate類內(nèi)只包含日期,不包含具體時(shí)間。只需要表示日期而不包含時(shí)間,就可以使用它。
// 只獲取日期
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);
同時(shí),還可以通過LocalDate獲取日期是月份的第幾天、周的第幾天,月份的天數(shù),是否為閏年等。看下面的代碼是不是非常方便。
LocalDate today = LocalDate.now();
// 月份中的第幾天
int dayOfMonth = today.getDayOfMonth();
// 一周的第幾天
DayOfWeek dayOfWeek = today.getDayOfWeek();
// 月份的天數(shù)
int length = today.lengthOfMonth();
// 是否為閏年
boolean leapYear = today.isLeapYear();
上面通過now獲取LocalDate對象,也可以通過靜態(tài)方法of()或parse創(chuàng)建任意一個(gè)日期。再也不用像之前一樣年只能從1900年開始,月必須從0開始等。
LocalDate oneDay = LocalDate.of(2019,10,1);
System.out.println(oneDay);
LocalDate parseDay = LocalDate.parse("2019-10-01");
System.out.println(parseDay);
打印結(jié)果: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));
同時(shí),針對日期還可延伸出MonthDay或YearMonth類,顧名思義,只包含月天或年月。同樣適用于equals方法來比較。
另外使用before和after可以比較兩個(gè)日期前后時(shí)間。
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"));
對日期進(jìn)行前一天后一天或前一個(gè)月的加減也變得十分方便。
LocalDate tomorrowDay = LocalDate.now().plusDays(1);
LocalDate nextMonth = LocalDate.now().plusMonths(1);
還有,我們在實(shí)戰(zhàn)的時(shí)候往往要獲取某一天的開始時(shí)間和當(dāng)天所在月的第一天等。
LocalDate.now().atStartOfDay();
LocalDate.now().with(TemporalAdjusters.firstDayOfMonth());
LocalTime-如何獲取時(shí)間
LocalTime和LocalDate類似,區(qū)別在于LocalDate不包含具體時(shí)間,而LocalTime包含具體時(shí)間。同樣可以使用now或of方法來獲得對象。
LocalTime localTime = LocalTime.now();
LocalTime oneTime = LocalTime.of(10,10,10);
LocalDate類似它也擁有parse、isBefore、獲取時(shí)間單元等方法,就不再贅述。
需要注意的是,LocalTime獲得的時(shí)間格式為:11:41:58.904。也就是,HH:mm:ss.nnn,這里nnn是納秒。
還有一個(gè)在實(shí)戰(zhàn)中查詢?nèi)掌趨^(qū)間時(shí)我們經(jīng)常定義的“23:59:59.99”常量再也不用自己定義了。
// 23:59:59.999999999
LocalTime maxTime = LocalTime.MAX;
// 00:00
LocalTime minTime = LocalTime.MIN;
LocalDateTime-日期和時(shí)間的組合
LocalDateTime表示日期和時(shí)間組合??梢酝ㄟ^of()方法直接創(chuàng)建,也可以調(diào)用LocalDate的atTime()方法或LocalTime的atDate()方法將LocalDate或LocalTime合并成一個(gè)LocalDateTime。
創(chuàng)建時(shí)間示例:
LocalDateTime now = LocalDateTime.now();
LocalDateTime oneTime = LocalDateTime.of(2019,10,14,10,12,12);
// 拼接日期
LocalTime.now().atDate(LocalDate.now());
LocalDateTime與LocalDate和LocalTime之間可以相互轉(zhuǎn)化。其他日期增減等操作與上面的類似。
Instant-獲取時(shí)間戳
Instant用于一個(gè)時(shí)間戳,與System.currentTimeMillis()類似,但I(xiàn)nstant可以精確到納秒(Nano-Second)。
Instant除了可以使用now()方法創(chuàng)建,還可以通過ofEpochSecond方法創(chuàng)建。
Instant now = Instant.now();
Instant.ofEpochSecond(365 * 24 * 60, 100);
其中ofEpochSecond第一個(gè)參數(shù)表示秒,第二個(gè)參數(shù)表示納秒。整體表示:從1970-01-01 00:00:00開始后的365天100納秒的時(shí)間點(diǎn)。
Duration-獲取時(shí)間段
Duration的內(nèi)部實(shí)現(xiàn)與Instant類似,但Duration表示時(shí)間段,通過between方法創(chuàng)建。
LocalDateTime from = LocalDateTime.now();
LocalDateTime to = LocalDateTime.now().plusDays(1);
Duration duration = Duration.between(from, to);
// 區(qū)間統(tǒng)計(jì)換算
// 總天數(shù)
long days = duration.toDays();
// 小時(shí)數(shù)
long hours = duration.toHours();
// 分鐘數(shù)
long minutes = duration.toMinutes();
// 秒數(shù)
long seconds = duration.getSeconds();
// 毫秒數(shù)
long milliSeconds = duration.toMillis();
// 納秒數(shù)
long nanoSeconds = duration.toNanos();
Duration對象還可以通過of()方法創(chuàng)建,該方法參數(shù)為時(shí)間段長度和時(shí)間單位。
// 7天
Duration duration1 = Duration.of(7, ChronoUnit.DAYS);
// 60秒
Duration duration2 = Duration.of(60, ChronoUnit.SECONDS);
Period-獲取日期段
Period與Duration類似,獲取一個(gè)時(shí)間段,只不過單位為年月日,也可以通過of方法和between方法創(chuàng)建,between方法接收的參數(shù)為LocalDate。
Period period = Period.of(1, 10, 25);
Period period1 = Period.between(LocalDate.now(), LocalDate.now().plusYears(1));
ZonedDateTime-創(chuàng)建時(shí)區(qū)時(shí)間
ZonedDateTime類,用于處理帶時(shí)區(qū)的日期和時(shí)間。ZoneId表示不同的時(shí)區(qū)。大約有40不同的時(shí)區(qū)。
獲取所有時(shí)區(qū)集合:
Set allZoneIds = ZoneId.getAvailableZoneIds();
創(chuàng)建時(shí)區(qū):
ZoneId zoneId = ZoneId.of("Asia/Shanghai");
把LocalDateTime轉(zhuǎn)換成特定的時(shí)區(qū):
ZonedDateTime zonedDateTime = ZonedDateTime.of(LocalDateTime.now(), zoneId);
另外和時(shí)區(qū)一起使用的類是OffsetDateTime類,OffsetDateTime是不變的,表示date-time偏移,存儲(chǔ)所有日期和時(shí)間字段,精確至納秒,從UTC/Greenwich計(jì)算偏移。
時(shí)間日期格式化
Java8對日期的格式化操作非常簡單,首先看到上面的類大多都提供了parse方法,可以直接通過解析字符串得到對應(yīng)的對象。
而日期和時(shí)間的格式化可通過LocalDateTime的format方法進(jìn)行格式化。
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預(yù)置的格式,也可以通過DateTimeFormatter.ofPattern方法來指定格式。
關(guān)鍵點(diǎn)回顧
Java8中關(guān)于時(shí)間日期的API有以下關(guān)鍵點(diǎn):
- 提供了javax.time.ZoneId用來處理時(shí)區(qū)。
- 提供了LocalDate與LocalTime類。
- 時(shí)間與日期API中的所有類都是線程安全的。
- 明確定義了基本的時(shí)間與日期概念。
- 核心API:Instant、LocalDate、LocalTime、LocalDateTime、ZonedDateTime。
- DateTimeFormatter類用于在Java中進(jìn)行日期的格式化與解析。
好了,關(guān)于Java8新特性的時(shí)間日期功能就將到這里,用起來是不是簡單明快多了,趕緊在項(xiàng)目中練練手吧。
原文鏈接:《Java8新特性時(shí)間日期庫DateTime API及示例》
程序新視界:精彩和成長都不容錯(cuò)過!
