Java 8 Time Api 使用指南-珍藏限量版

1.概述

Java 8為Date和Time引入了新的API,以解決舊java.util.Datejava.util.Calendar的缺點。作為本文的一部分,讓我們從現(xiàn)有Date和Calendar API存在的一些問題入手,來探討新的Java 8 Date和Time API如何解決這些問題。我們還將搞一搞Java 8時間類庫中的核心類,比如LocalDate, LocalTime, LocalDateTime, ZonedDateTime, Period, Duration以及它們的api。

2. 舊的時間API(java8之前)的問題

  • 線程安全 - DateCalendar類不是線程安全的,使開發(fā)者難以調(diào)試這些api的并發(fā)問題,需要編寫額外的代碼來處理線程安全。Java 8中引入的新的Date和Time API是不可變的和線程安全的,使得這些痛點得以解決。
  • API設(shè)計和易于理解 - 舊的時間api非常難以理解,操作都非常復(fù)雜,非常繞口,沒有提供一些常用的解析轉(zhuǎn)換方法。新的時間API是以ISO為中心的,并遵循 date, time, duration 和 periods的一致域模型。提供了一些非常實用方法以支持最常見的操作。不再需要我們自己封裝一些時間操作類,而且描述語義化。
  • ZonedDate和Time - 在舊的時間api中開發(fā)人員必須編寫額外的邏輯來處理舊API的時區(qū)邏輯,而使用新的API,可以使用 Local和ZonedDate / Time API來處理時區(qū)。無需過多關(guān)心時區(qū)轉(zhuǎn)換問題。

3. 使用LocalDate,LocalTime和LocalDateTime

最常用的類是LocalDateLocalTimeLocalDateTime。正如他們的名字所示,它們代表與上下文相結(jié)合的本地日期/時間。
這些類主要用于不需要在上下文中明確指定時區(qū)的情況。作為本節(jié)的一部分,我們將介紹最常用的API。

3.1 使用LocalDate

LocalDate表示在ISO格式(YYYY-MM-DD)下的不帶具體時間的日期。常用于表示生日或者我們最關(guān)心的發(fā)工資的的日期。獲取當(dāng)前系統(tǒng)時鐘下的日期,如下所示:
LocalDate localDate = LocalDate.now();
表示特定日,月和年的LocalDate可以使用“ of ”方法或使用“ parse ”方法獲得。例如,以下代碼段代表2015年2月20日的LocalDate:
LocalDate.of(2015, 02, 20); LocalDate.parse("2015-02-20");
是不是非常直觀而且方便呢!LocalDate提供各種實用方法,以獲得各種日期信息。讓我們快速瀏覽一下這些API方法。以下代碼段獲取當(dāng)前本地日期并添加一天:
LocalDate tomorrow = LocalDate.now().plusDays(1);
此示例獲取當(dāng)前日期并減去一個月。請注意它是如何接受枚舉作為時間單位的:
LocalDate previousMonthSameDay = LocalDate.now().minus(1, ChronoUnit.MONTHS);
在以下兩個代碼示例中,我們分析日期“2016-06-12”并分別獲取星期幾和月中的某天。注意返回值,第一個是表示DayOfWeek的對象,而第二個是表示月份的序數(shù)值的int:

DayOfWeek sunday = LocalDate.parse("2019-06-12").getDayOfWeek(); 
int twelve = LocalDate.parse("2016-09-12").getDayOfMonth();

我們還可以測試一個日期是否發(fā)生在閏年,如果用老方法怕不是要上天:
boolean leapYear = LocalDate.now().isLeapYear();
判斷日期的先后:

boolean notBefore = LocalDate.parse("2019-06-12").isBefore(LocalDate.parse("2019-06-11")); 
boolean isAfter = LocalDate.parse("2019-06-12")  .isAfter(LocalDate.parse("2019-06-11"));

日期邊界可以從給定日期獲得。在以下兩個示例中,我們得到LocalDateTime,它代表給定日期的一天的開始(2016-06-12T00:00)和代表月初的LocalDate(2019-06-01):

LocalDateTime beginningOfDay = LocalDate.parse("2019-06-12").atStartOfDay();
LocalDate firstDayOfMonth = LocalDate.parse("2019-09-12").with(TemporalAdjusters.firstDayOfMonth());

現(xiàn)在讓我們來看看我們?nèi)绾问褂卯?dāng)?shù)貢r間LocalTime

3.2 使用LocalTime

在本地時間表示不帶日期的時間。與LocalDate類似,可以從系統(tǒng)時鐘或使用“parse”和“of”方法創(chuàng)建LocalTime實例。快速瀏覽下面的一些常用API。可以從系統(tǒng)時鐘創(chuàng)建當(dāng)前LocalTime的實例,如下所示:
LocalTime now = LocalTime.now();
在下面的代碼示例中,我們通過解析字符串表示創(chuàng)建表示06:30 AM 的LocalTime
LocalTime sixThirty = LocalTime.parse("06:30");
方法“of”可用于創(chuàng)建LocalTime。例如,下面的代碼使用“of”方法創(chuàng)建表示06:30 AM的LocalTime
LocalTime sixThirty = LocalTime.of(6, 30);
下面的示例通過解析字符串來創(chuàng)建LocalTime,并使用“plus”API為其添加一小時。結(jié)果將是代表07:30 AM的LocalTime
LocalTime sevenThirty = LocalTime.parse("06:30").plus(1, ChronoUnit.HOURS);
各種getter方法可用于獲取特定的時間單位,如小時,分鐘和秒,如下所示獲取小時:
int six = LocalTime.parse("06:30").getHour();
LocalDate一樣檢查特定時間是否在另一特定時間之前或之后。下面的代碼示例比較結(jié)果為true的兩個LocalTime
boolean isbefore = LocalTime.parse("06:30").isBefore(LocalTime.parse("07:30"));
一天中的最大,最小和中午時間可以通過LocalTime類中的常量獲得。在執(zhí)行數(shù)據(jù)庫查詢以查找給定時間范圍內(nèi)的記錄時,這非常有用。例如,下面的代碼代表23:59:59.99
LocalTime maxTime = LocalTime.MAX;
現(xiàn)在讓我們深入了解LocalDateTime

3.3 使用LocalDateTime

所述LocalDateTime用于表示日期和時間的組合。當(dāng)我們需要結(jié)合日期和時間時,這是最常用的類。該類提供了各種API,我們將介紹一些最常用的API。類似于LocalDateLocalTime從系統(tǒng)時鐘獲取LocalDateTime的實例:
LocalDateTime.now();
下面的代碼示例解釋了如何使用工廠“of”和“parse”方法創(chuàng)建實例。結(jié)果將是代表2019年2月20日06:30 AMLocalDateTime實例:

LocalDateTime.of(2019, Month.FEBRUARY, 20, 06, 30);
LocalDateTime.parse("2019-02-20T06:30:00");

有一些實用的API可以支持特定時間單位的時間運算,例如天,月,年和分鐘。以下代碼示例演示了“加”和“減”方法的用法。這些API的行為與LocalDateLocalTime中的 API完全相同:

localDateTime.plusDays(1);
localDateTime.minusHours(2);

Getter方法可用于提取類似于日期和時間類的特定單位。鑒于上面的LocalDateTime實例,下面的代碼示例將返回2月份的月份:
localDateTime.getMonth();

4.使用ZonedDateTime API

當(dāng)我們需要處理時區(qū)特定的日期和時間時,Java 8提供了ZonedDateTime類。ZoneID是用于表示不同區(qū)域的標(biāo)識符。大約有40個不同的時區(qū),使用ZoneID表示它們,如下所示
下面的代碼我們來獲取下“亞洲/上海”時區(qū):
ZoneId zoneId = ZoneId.of("Aisa/Shanghai");
獲取所有的時區(qū):
Set<String> allZoneIds = ZoneId.getAvailableZoneIds();
LocalDateTime轉(zhuǎn)化為特定的時區(qū)中的時間:
ZonedDateTime zonedDateTime = ZonedDateTime.of(localDateTime, zoneId);
ZonedDateTime提供解析方法來獲取時區(qū)的特定日期時間:
ZonedDateTime.parse("2019-06-03T10:15:30+01:00[Aisa/Shanghai]");
使用時區(qū)的另一種方法是使用OffsetDateTimeOffsetDateTime是具有偏移量的日期時間的不可變表示形式。此類存儲所有日期和時間字段,精確到納秒,以及從UTC/格林威治的偏移量。可以使用ZoneOffset創(chuàng)建OffsetDateTime實例。這里我們創(chuàng)建一個LocalDateTime來表示2015年2月20日上午6:30
LocalDateTime localDateTime = LocalDateTime.of(2019, Month.FEBRUARY, 20, 06, 30);
然后我們通過創(chuàng)建ZoneOffset并為LocalDateTime實例設(shè)置來增加兩個小時:

ZoneOffset offset = ZoneOffset.of("+02:00"); 
OffsetDateTime offSetByTwo = OffsetDateTime.of(localDateTime, offset);

我們現(xiàn)在假定本地日期時間為2019-02-20 06:30 +02:00。現(xiàn)在讓我們繼續(xù)討論如何使用PeriodDuration類修改日期和時間值。

5.使用Period和Duration

  • Period : 用于計算兩個日期(年月日)間隔。
  • Duration : 用于計算兩個時間(秒,納秒)間隔。

5.1 使用Period

Period 類被廣泛地用于修改給定的日期的值或者獲取兩個日期之間的差值:

LocalDate initialDate = LocalDate.parse("2007-05-10");
LocalDate finalDate = initialDate.plus(Period.ofDays(5));

Period 類有各種getter方法,如getYearsgetMonthsgetDays從獲取值周期對象。下面的代碼示例返回一個int值為5,是基于上面示例的逆序操作:
int five = Period.between(finalDate, initialDate).getDays();
Period 可以在特定的單元獲得兩個日期之間的如天或月或數(shù)年,使用ChronoUnit.between
int five = ChronoUnit.DAYS.between(finalDate , initialDate);
此代碼示例返回五天。讓我們繼續(xù)看看Duration類。

5.2 使用Duration

類似PeriodDuration類是用來處理時間。在下面的代碼中,我們創(chuàng)建一個本地時間上午6:30,然后加30秒的持續(xù)時間,以使本地時間上午6時30分30秒的:

LocalTime initialTime = LocalTime.of(6, 30, 0); 
LocalTime finalTime = initialTime.plus(Duration.ofSeconds(30));

兩個時刻之間的持續(xù)時間可以作為持續(xù)時間或作為特定單位獲得。在第一個代碼片段中,我們使用Duration類的between()方法來查找finalTimeinitialTime之間的時間差,并以秒為單位返回差異:
int thirty = Duration.between(finalTime, initialTime).getSeconds();
在第二個例子中,我們使用ChronoUnit類的between()方法來執(zhí)行相同的操作:
int thirty = ChronoUnit.SECONDS.between(finalTime, initialTime);
現(xiàn)在我們來看看如何將舊的DateCalendar 轉(zhuǎn)換為新的DateTime

6.與日期和日歷的兼容性

Java 8添加了toInstant()方法,該方法有助于將舊API中的Date和Calendar實例轉(zhuǎn)換為新的Date Time API,如下面的代碼片段所示:

LocalDateTime.ofInstant(date.toInstant(), ZoneId.systemDefault());
LocalDateTime.ofInstant(calendar.toInstant(), ZoneId.systemDefault());

所述LocalDateTime可以從如下“ofEpochSecond"方法來構(gòu)造。以下代碼的結(jié)果將是代表2019-06-13T11:34:50LocalDateTime
LocalDateTime.ofEpochSecond(1465817690, 0, ZoneOffset.UTC);
現(xiàn)在讓我們繼續(xù)進(jìn)行日期和時間格式化。

7. 日期和時間格式化

Java 8提供了用于輕松格式化日期和時間的 API :
LocalDateTime localDateTime = LocalDateTime.of(2019, Month.JANUARY, 25, 6, 30);
以下代碼傳遞ISO日期格式以格式化本地日期。結(jié)果將是2019-01-25
String localDateString = localDateTime.format(DateTimeFormatter.ISO_DATE);
DateTimeFormatter提供多種標(biāo)準(zhǔn)格式選項。也可以提供自定義模式來格式化方法,如下所示對上面的例子進(jìn)行自定義格式化,它將返回LocalDate2019/01/25
localDateTime.format(DateTimeFormatter.ofPattern("yyyy/MM/dd"));
我們可以將格式樣式傳遞為SHORTLONGMEDIUM作為格式化選項的一部分。下面的代碼示例將在2019年1月25日06:30:00 給出表示LocalDateTime的輸出:
localDateTime.format(DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM).withLocale(Locale.UK);
最后讓我們看看Java 8 Core Date / Time API 可用的替代方案。并不是所有的項目都使用java 8。

8.替代方案

8.1 使用Threeten 類庫

對于從Java 7或Java 6這些老項目來說可以使用Threeten ,然后可以像在上面java 8一樣使用相同的功能,一旦你遷移到j(luò)ava 8 只需要修改你的包路徑代碼而無需變更。通過在項目中引用以下pom依賴項就可以立即使用:

 <dependency>    
   <groupId>org.threeten</groupId>    
   <artifactId>threetenbp</artifactId>    
   <version>LATEST</version>
 </dependency>

8.2 Joda-Time類庫

Java 8 日期和時間庫的另一種替代方案是老牌時間處理類庫Joda-Time。事實上,Java 8 Date Time API 吸收了大量的Joda-Time庫。該庫提供了Java 8 Date Time項目中支持的幾乎所有功能。通過在項目中引用以下pom依賴項就可以立即使用:

<dependency>    
   <groupId>joda-time</groupId>    
   <artifactId>joda-time</artifactId>    
   <version>LATEST</version>
</dependency>

關(guān)注公眾號:碼農(nóng)小胖哥,獲取更多資訊

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

推薦閱讀更多精彩內(nèi)容

  • 當(dāng)你開始使用Java操作日期和時間的時候,會有一些棘手。你也許會通過System.currentTimeMilli...
    程序猿的那些事閱讀 2,288評論 0 1
  • 今天整了整頭發(fā),回到家已經(jīng)是8點多了!吃過飯,我就開始檢查兒子作業(yè),他主動拿出語文書背第10課五星紅旗!第一遍不太...
    親子園閱讀 186評論 0 1
  • 小時候,聽不了父母的嘮叨,總想著趕緊長大,離開家,去一座我喜歡的城市,過自己喜歡的生活。長大后,真的離開了家,...
    馨語新愿閱讀 259評論 0 0
  • 斷更19天,原來放棄一件事情,比堅持一件事情,容易那么多。日更的時候,覺得堅持打卡特別難,一旦中斷,卻發(fā)現(xiàn)日子是那...
    子昊貢一閱讀 130評論 0 0