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及示例


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

程序新視界-微信公眾號
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,333評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,491評論 3 416
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,263評論 0 374
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,946評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,708評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,186評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,255評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,409評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,939評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,774評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,976評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,518評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,209評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,641評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,872評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,650評論 3 391
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,958評論 2 373

推薦閱讀更多精彩內容