日期時(shí)間類（2022版）

日期時(shí)間類物流信息管理系統(tǒng)開發(fā)在開發(fā)中經(jīng)常需要處理日期和時(shí)間，Java提供了一套專門用于處理日期時(shí)間的API，在日期時(shí)間類中了包含LocalDate類、LocalTime類、Instant類、Duration類以及Period類等，這些類都包含在java.time包中。日期時(shí)間類類的名稱功能描述Instant表示時(shí)刻，代表的是時(shí)間戳LocalDate不包含具體時(shí)間的日期LocalTime不含日期的時(shí)間LocalDateTime包含了日期及時(shí)間Duration基于時(shí)間的值測(cè)量時(shí)間量Period計(jì)算日期時(shí)間差異，只能精確到年月日Clock時(shí)鐘系統(tǒng)，用于查找當(dāng)前時(shí)刻1Instant類Instant類代表的是某個(gè)時(shí)間。其內(nèi)部是由兩個(gè)Long字段組成，第一部分保存的是標(biāo)準(zhǔn)Java計(jì)算時(shí)代（就是1970年1月1日開始）到現(xiàn)在的秒數(shù)，第二部分保存的是納秒數(shù)。1Instant類方法聲明功能描述now()從系統(tǒng)時(shí)鐘獲取當(dāng)前瞬時(shí)now(Clockclock)從指定時(shí)鐘獲取當(dāng)前瞬時(shí)ofEpochSecond(longepochSecond):使用從自標(biāo)準(zhǔn)Java計(jì)算時(shí)代開始的秒數(shù)獲得一個(gè)Instant的實(shí)例。ofEpochMilli(longepochMilli):使用從自標(biāo)準(zhǔn)Java計(jì)算時(shí)代開始的秒數(shù)獲得一個(gè)Instant的實(shí)例。getEpochSecond():從1970-01-01T00：00：00Z的Java時(shí)代獲取秒數(shù)。getNano():從第二個(gè)開始就從時(shí)間線獲得納秒的數(shù)量。parse(CharSequencetext)從一個(gè)文本字符串（如2007-12-03T10:15:30.00Z獲取一個(gè)Instant的實(shí)例。from(TemporalAccessortenporal)從時(shí)間對(duì)象獲取一個(gè)Instant的實(shí)例。1Instant類1importjava.time.Instant;2publicclassExample20{3publicstaticvoidmain(String[]args){4//Instant時(shí)間戳類從1970-01-0100:00:00截止到當(dāng)前時(shí)間的毫秒值5Instantnow=Instant.now();6System.out.println("從系統(tǒng)獲取的當(dāng)前時(shí)刻為："+now);7Instantinstant=Instant.ofEpochMilli(1000*60*60*24);8System.out.println("計(jì)算機(jī)元年增加毫秒數(shù)后為："+instant);接下來(lái)通過(guò)一個(gè)案例演示Instant類的使用。1Instant類9Instantinstant1=Instant.ofEpochSecond(60*60*24);10System.out.println("計(jì)算機(jī)元年增加秒數(shù)后為："+instant1);11System.out.println("獲取的秒值為："+Instant.parse12("2007-12-03T10:15:30.44Z").getEpochSecond());13System.out.println("獲取的納秒值為："+Instant.parse14("2007-12-03T10:15:30.44Z").getNano());15System.out.println("從時(shí)間對(duì)象獲取的Instant實(shí)例為："+16Instant.from(now));17}18}1Instant類程序運(yùn)行結(jié)果如下圖1Instant類上述代碼中，第5行代碼使用Instant的now()方法獲取了系統(tǒng)中的當(dāng)前時(shí)刻；第7行代碼使用Instant的ofEpochMilli()方法獲取了計(jì)算機(jī)元年增加毫秒數(shù)后的結(jié)果；第9行代碼使用Instant的ofEpochSecond()方法獲取了計(jì)算機(jī)元年增加秒數(shù)后的結(jié)果；第11~12行代碼使用Instant的getEpochSecond()方法獲取了從“007-12-03T10:15:30.44Z”到現(xiàn)在的秒值；第13~14行代碼使用getNano()方法獲取了從“007-12-03T10:15:30.44Z”到現(xiàn)在的納秒值；第15~16行代碼使用from()方法從時(shí)間對(duì)象獲取了Instant的實(shí)例。從運(yùn)行結(jié)果中可以看出每個(gè)方法所輸出結(jié)果的格式。需要注意的是，now()方法默認(rèn)獲取的是西六區(qū)時(shí)間；parse()是從文本字符串獲取的Instant實(shí)例。2LocalData類LocalData類僅用來(lái)表示日期。通常表示的是年份和月份，該類不能代表時(shí)間線上的即時(shí)信息，只是日期的描述。在LocalData類中提供了兩個(gè)獲取日期對(duì)象的方法now()和of(intyear,intmonth,intdayOfMonth),

具體代碼如下所示：//從一年，一個(gè)月和一天獲得一個(gè)LocalDate的實(shí)例LocalDatedate=LocalDate.of(2020,12,12);//從默認(rèn)時(shí)區(qū)的系統(tǒng)時(shí)鐘獲取當(dāng)前日期LocalDatenow1=LocalDate.now();2LocalData類LocalData還提供了日期格式化、增減年月日等一系列的常用方法。方法聲明功能描述getYear()獲取年份字段getMonth()使用Month枚舉獲取月份字段getMonthValue()將月份字段從1到12getDayOfMonth()獲取當(dāng)月第幾天字段format(DateTimeFormatter

formatter)使用指定的格式化程序格式化此日期。isBefore(ChronoLocalDate

other)檢查此日期是否在指定日期之前。isAfter(ChronoLocalDate

other)檢查此日期是否在指定日期之后。isEqual(ChronoLocalDate

other)檢查此日期是否等于指定的日期。isLeapYear()根據(jù)ISO培訓(xùn)日歷系統(tǒng)規(guī)則，檢查年份是否是閏年。2LocalData類方法聲明功能描述parse(CharSequence

text)從一個(gè)文本字獲取一個(gè)

LocalDate的實(shí)例。parse(CharSequence

text,

DateTimeFormatter

formatter)使用特定格式化

LocalDate從文本字符串獲取

LocalDate的實(shí)例。plusYears(long

yearsToAdd)增加指定年份plusMonths(long

monthsToAdd)增加指定月份plusDays(long

daysToAdd)增加指定日數(shù)minusYears(long

yearsToSubtract)減少指定年份minusMonths(long

monthsToSubtract)減少指定月份minusDays(long

daysToSubtract)減少指定日數(shù)withYear(int

year)指定年withMonth(int

month)指定月withDayOfYear(intdayOfYear)指定日2LocalData類1importjava.time.LocalDate;2importjava.time.format.DateTimeFormatter;3publicclassExample21{4publicstaticvoidmain(String[]args){5//獲取日期時(shí)分秒6LocalDatenow=LocalDate.now();7LocalDateof=LocalDate.of(2015,12,12);8System.out.println("1.LocalData的獲取及格式化的相關(guān)方法--------");9System.out.println("從LocalData實(shí)例獲取的年份為："+now.getYear());10System.out.println("從LocalData實(shí)例獲取的月份："11+now.getMonthValue());接下來(lái)通過(guò)一個(gè)案例來(lái)學(xué)習(xí)這些方法的使用。2LocalData類12System.out.println("從LocalData實(shí)例獲取當(dāng)天在本月的第幾天："+13now.getDayOfMonth());14System.out.println("將獲取到的Loacaldata實(shí)例格式化為："+15now.format(DateTimeFormatter.ofPattern("yyyy年MM月dd日")));16System.out.println("2.LocalData判斷的相關(guān)方法----------------");17System.out.println("判斷日期of是否在now之前："+of.isBefore(now));18System.out.println("判斷日期of是否在now之后："+of.isAfter(now));19System.out.println("判斷日期of和now是否相等："+now.equals(of));20System.out.println("判斷日期of是否時(shí)閏年："+of.isLeapYear());2LocalData類21//給出一個(gè)符合默認(rèn)格式要求的日期字符串22System.out.println("3.LocalData解析以及加減操作的相關(guān)方法---------");23StringdateStr="2020-02-01";24System.out.println("把日期字符串解析成日期對(duì)象后為"+25LocalDate.parse(dateStr));26System.out.println("將LocalData實(shí)例年份加1為："+now.plusYears(1));27System.out.println("將LocalData實(shí)例天數(shù)減10為："28+now.minusDays(10));29System.out.println("將LocalData實(shí)例指定年份為2014："+30now.withYear(2014));31}32}2LocalData類程序運(yùn)行結(jié)果如下圖2LocalData類第6行代碼定義了一個(gè)名稱為now的LocalDate無(wú)參實(shí)例，第7行代碼定義了一個(gè)名稱為of的LocalDate有參實(shí)例，參數(shù)值為“2015，12，12”；第9~15行代碼使用了LocalDate的獲取及格式化的相關(guān)方法，其中第9行代碼使用LocalDate的getYerar()方法獲取了當(dāng)前的年份，第10~11行代碼使用LocalDate的getMonthValue()方法獲取了當(dāng)前的月份，第12~13行代碼使用LocalDate的getDayOfMonth()方法獲取了當(dāng)前在本月的第幾天，第14~15行代碼使用LocalDate的farmot()方法將日期格式設(shè)置為（yyyy年MM月dd日）。2LocalData類第17~21行代碼使用了LocalDate判斷的相關(guān)方法，其中第17行代碼使用LocalDate的isBefore()判斷日期of是否在當(dāng)前時(shí)間前，第18行代碼使用LocalDate的isAfter()方法判斷日期of是否在當(dāng)前時(shí)間后，第19行代碼使用LocalDate的equals()方法判斷日期of是否和now相等，第20行代碼使用LocalDate的isLeapYear()方法判斷日期of是否為閏年。2LocalData類

第23~30行代碼使用了LocalDate解析以及加減操作的相關(guān)方法，其中第23行代碼定義了一個(gè)名稱為dateStr的字符串，dateStr的值為“2020—02—01”，第24~25行代碼使用LocalDate的parse()方法將dateStr解析為日期對(duì)象，第26行代碼使用LocalDate的plusYears()方法將now實(shí)例年份加1，第27~28行代碼使用LocalDate的minusDays()方法將now實(shí)例天數(shù)減10，第29~30行代碼使用LocalDate的withYear()方法將now實(shí)例年份指定為2014。3LocalTime類與LocalDataTime類LocalTime類用來(lái)表示時(shí)間，通常表示的是小時(shí)分鐘秒。與LocalData類一樣，該類不能代表時(shí)間線上的即時(shí)信息，只是時(shí)間的描述。在LocalTime類中提供了獲取時(shí)間對(duì)象的方法，與LocalData用法類似。同時(shí)LocalTime類也提供了與日期類相對(duì)應(yīng)的時(shí)間格式化、增減時(shí)分秒等常用方法，這些方法與日期類相對(duì)應(yīng)，這里我們不再詳細(xì)列舉。3LocalTime類與LocalDataTime類1importjava.time.LocalTime;2importjava.time.format.DateTimeFormatter;3publicclassExample22{4publicstaticvoidmain(String[]args){5//1.獲取當(dāng)前時(shí)間，包含毫秒數(shù)6LocalTimetime=LocalTime.now();7LocalTimeof=LocalTime.of(9,23,23);8System.out.println("從LocalTime獲取的小時(shí)為："+time.getHour());接下來(lái)我們通過(guò)一個(gè)案例來(lái)學(xué)習(xí)一下LocalTime類的方法。3LocalTime類與LocalDataTime類9System.out.println("將獲取到的LoacalTime實(shí)例格式化為："+10time.format(DateTimeFormatter.ofPattern("HH:mm:ss")));11System.out.println("判斷時(shí)間of是否在now之前："+of.isBefore(time));12System.out.println("將時(shí)間字符串解析為時(shí)間對(duì)象后為："+13LocalTime.parse("12:15:30"));14System.out.println("從LocalTime獲取當(dāng)前時(shí)間，不包含毫秒數(shù)："+15time.withNano(0));16}17}3LocalTime類與LocalDataTime類程序運(yùn)行結(jié)果如下圖3LocalTime類與LocalDataTime類LocalDataTime類是LocalData類與LocalTime類的綜合，它即包含日期也包含時(shí)間，通過(guò)查看API可以知道，LocalDataTime類中的方法包含了LocalData類與LocalTime類的方法。

需要注意的是，LocalDateTime默認(rèn)的格式是2020-02-29T21:23:26.774，這可能與我們經(jīng)常使用的格式不太符合，所以它經(jīng)常和DateTimeFormatter一起使用指定格式，除了LocalData與LocalTime類中的方法，額外提供了轉(zhuǎn)換的方法。3LocalTime類與LocalDataTime類1importjava.time.LocalDateTime;2importjava.time.format.DateTimeFormatter;3publicclassExample23{4publicstaticvoidmain(String[]args){5//獲取當(dāng)前年月日，時(shí)分秒6LocalDateTimenow=LocalDateTime.now();7System.out.println("獲取的當(dāng)前日期時(shí)間為："+now);8System.out.println("將目標(biāo)LocalDateTime轉(zhuǎn)換為相應(yīng)的LocalDate實(shí)例:"+9now.toLocalDate());下面我們通過(guò)一個(gè)案例來(lái)學(xué)習(xí)LocalDataTime類中特有的方法。3LocalTime類與LocalDataTime類10System.out.println("將目標(biāo)LocalDateTime轉(zhuǎn)換為相應(yīng)的LocalTime實(shí)例:"+11now.toLocalTime());12//指定格式13DateTimeFormatterofPattern=DateTimeFormatter.ofPattern14("yyyy年MM月dd日HH時(shí)mm分ss秒");15System.out.println("格式化后的日期時(shí)間為："+now.format(ofPattern));16}17}3LocalTime類與LocalDataTime類程序運(yùn)行結(jié)果如下圖3LocalTime類與LocalDataTime類

第6行代碼定義了一個(gè)名稱為now的LocalDateTime實(shí)例，在7行代碼直接打印當(dāng)前日期now，第8~9行代碼使用LocalDateTime的toLocalDate()方法將now轉(zhuǎn)換為相應(yīng)的LocalDate實(shí)例，第10~11行代碼使用toLocalTime()方法將now轉(zhuǎn)換為相應(yīng)的LocalTime實(shí)例，第13~14行代碼使用DateTimeFormatter的ofPattern()方法將時(shí)間格式指定為“yyyy年MM月DD日HH時(shí)mm分ss秒”，第15行代碼使用LocalDateTime的format()方法將now的時(shí)間按指定格式打印。方法聲明功能描述between(Temporal

startInclusive,Temporal

endExclusive)獲取一個(gè)Duration表示兩個(gè)時(shí)間對(duì)象之間的持續(xù)時(shí)間。toDays():將時(shí)間轉(zhuǎn)換為以天為單位的toHours():將時(shí)間轉(zhuǎn)換為以時(shí)為單位的toMinutes():將時(shí)間轉(zhuǎn)換為以分鐘為單位的toMillis()：將時(shí)間轉(zhuǎn)換為以毫秒為單位的toNanos():將時(shí)間轉(zhuǎn)換為以納秒為單位的4Period和Duration類Duration類基于時(shí)間值，其作用范圍是天、時(shí)、分、秒、毫秒和納秒，Duration類的常用方法如表。1.Duration類4Period和Duration類1importjava.time.Duration;2importjava.time.LocalTime;3publicclassExample24{4publicstaticvoidmain(String[]args){5LocalTimestart=LocalTime.now();6LocalTimeend=LocalTime.of(20,13,23);7Durationduration=Duration.between(start,end);8//間隔的時(shí)間9System.out.println("時(shí)間間隔為："+duration.toNanos()+"納秒");10System.out.println("時(shí)間間隔為："+duration.toMillis()+"毫秒");11System.out.println("時(shí)間間隔為："+duration.toHours()+"小時(shí)");12}13}接下來(lái)通過(guò)一個(gè)案例講解Duration類中常用方法的使用。4Period和Duration類程序運(yùn)行結(jié)果如下圖4Period和Duration類上述代碼中，第7行代碼通過(guò)between()方法計(jì)算出