JDK8 時間API

背景

JDK8中增加了一套全新的日期時間API，這裏進行總結下，方便查詢使用。

新的時間及日期API位於 java.time 包中，下面是一些關鍵類。

Instant：代表的是時間戳。

LocalDate：不包含具體時間的日期。

LocalTime：不含日期的時間。

LocalDateTime：包含了日期及時間。

回到頂部

獲取日期時間的信息

LocalDate

LocalDate類獲取日期信息。格式爲 2018-09-06

 1         LocalDate nowDate = LocalDate.now();
 2         System.out.println("今天的日期：" + nowDate);//今天的日期：2018-09-06
 3         int year = nowDate.getYear();//年：一般用這個方法獲取年
 4         System.out.println("year：" + year);//year：2018
 5         int month = nowDate.getMonthValue();//月：一般用這個方法獲取月
 6         System.out.println("month：" + month);//month：9
 7         int day = nowDate.getDayOfMonth();//日：當月的第幾天，一般用這個方法獲取日
 8         System.out.println("day：" + day);//day：6
 9         
10         int dayOfYear = nowDate.getDayOfYear();//日：當年的第幾天
11         System.out.println("dayOfYear：" + dayOfYear);//dayOfYear：249
12         
13         //星期
14         System.out.println(nowDate.getDayOfWeek());//THURSDAY
15         System.out.println(nowDate.getDayOfWeek().getValue());//4
16         //月份
17         System.out.println(nowDate.getMonth());//SEPTEMBER
18         System.out.println(nowDate.getMonth().getValue());//9

LocalTime

LocalTime類獲取時間信息。格式爲 15:33:56.749

 1         LocalTime nowTime = LocalTime.now();
 2         System.out.println("今天的時間：" + nowTime);//今天的時間：15:33:56.749
 3         int hour = nowTime.getHour();//時
 4         System.out.println("hour：" + hour);//hour：15
 5         int minute = nowTime.getMinute();//分
 6         System.out.println("minute：" + minute);//minute：33
 7         int second = nowTime.getSecond();//秒
 8         System.out.println("second：" + second);//second：56
 9         int nano = nowTime.getNano();//納秒
10         System.out.println("nano：" + nano);//nano：749000000

LocalDateTime

LocalDateTime類獲取日期時間信息。格式爲 2018-09-06T15:33:56.750

 1         LocalDateTime nowDateTime = LocalDateTime.now();
 2         System.out.println("今天是：" + nowDateTime);//今天是：2018-09-06T15:33:56.750
 3         System.out.println(nowDateTime.getYear());//年
 4         System.out.println(nowDateTime.getMonthValue());//月
 5         System.out.println(nowDateTime.getDayOfMonth());//日
 6         System.out.println(nowDateTime.getHour());//時
 7         System.out.println(nowDateTime.getMinute());//分
 8         System.out.println(nowDateTime.getSecond());//秒
 9         System.out.println(nowDateTime.getNano());//納秒
10         //日：當年的第幾天
11         System.out.println("dayOfYear：" + nowDateTime.getDayOfYear());//dayOfYear：249
12         //星期
13         System.out.println(nowDateTime.getDayOfWeek());//THURSDAY
14         System.out.println(nowDateTime.getDayOfWeek().getValue());//4
15         //月份
16         System.out.println(nowDateTime.getMonth());//SEPTEMBER
17         System.out.println(nowDateTime.getMonth().getValue());//9

回到頂部

獲取指定的時間日期

LocalDate

1         System.out.println(LocalDate.of(1991, 11, 11));//直接傳入對應的年月日
2         System.out.println(LocalDate.of(1991, Month.NOVEMBER, 11));//相對上面只是把月換成了枚舉
3         LocalDate birDay = LocalDate.of(1991, 11, 11);
4         System.out.println(LocalDate.ofYearDay(1991, birDay.getDayOfYear()));//第一個參數爲年，第二個參數爲當年的第多少天
5         System.out.println(LocalDate.ofEpochDay(birDay.toEpochDay()));//參數爲距離1970-01-01的天數
6         
7         System.out.println(LocalDate.parse("1991-11-11"));
8         System.out.println(LocalDate.parse("19911111",DateTimeFormatter.ofPattern("yyyyMMdd")));

LocalTime

1         System.out.println(LocalTime.of(8, 20));//時分
2         System.out.println(LocalTime.of(8, 20, 30));//時分秒
3         System.out.println(LocalTime.of(8, 20, 30, 150));//時分秒納秒
4         LocalTime mTime = LocalTime.of(8, 20, 30, 150);
5         System.out.println(LocalTime.ofSecondOfDay(mTime.toSecondOfDay()));//參數爲距離當天零時的秒數
6         System.out.println(LocalTime.ofNanoOfDay(mTime.toNanoOfDay()));//參數爲距離當天零時的納秒數
7         
8         System.out.println(LocalTime.parse("08:20:30"));
9         System.out.println(LocalTime.parse("082030", DateTimeFormatter.ofPattern("HHmmss")));

LocalDateTime

這裏的 birDay 和 mTime 複用上面的變量。

 1         System.out.println(LocalDateTime.of(birDay, mTime));//參數爲LocalDate和LocalTime
 2         System.out.println(LocalDateTime.of(1991, 11, 11, 8, 20));
 3         System.out.println(LocalDateTime.of(1991, Month.NOVEMBER, 11, 8, 20));
 4         System.out.println(LocalDateTime.of(1991, 11, 11, 8, 20, 30));
 5         System.out.println(LocalDateTime.of(1991, Month.NOVEMBER, 11, 8, 20, 30));
 6         System.out.println(LocalDateTime.of(1991, 11, 11, 8, 20, 30, 150));
 7         System.out.println(LocalDateTime.of(1991, Month.NOVEMBER, 11, 8, 20, 30, 150));
 8         
 9         System.out.println(LocalDateTime.parse("1991-11-11T08:20:30"));
10         System.out.println(LocalDateTime.parse("1991-11-11 08:20:30", DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));

回到頂部

日期時間的比較

在JDK8中，LocalDate類中使用isBefore()、isAfter()、equals()方法來比較兩個日期，可直接進行比較。

以LocalDate爲例。

1         LocalDate myDate = LocalDate.of(2018, 9, 5);
2         LocalDate nowDate = LocalDate.now();
3         System.out.println("今天是2018-09-06嗎？ " + nowDate.equals(myDate));//今天是2018-09-06嗎？ false
4         System.out.println(myDate + "是否在" + nowDate + "之前？ " + myDate.isBefore(nowDate));//2018-09-05是否在2018-09-06之前？ true
5         System.out.println(myDate + "是否在" + nowDate + "之後？ " + myDate.isAfter(nowDate));//2018-09-05是否在2018-09-06之後？ false

如何在java中判斷是否是某個節日或者重複事件，使用MonthDay類。這個類由月日組合，不包含年信息，可以用來代表每年重複出現的一些日期。它和新的日期庫中的其他類一樣也都是不可變且線程安全的。

1         LocalDate birDate = LocalDate.of(1991, 10, 1);
2         LocalDate nowDate = LocalDate.now();
3         MonthDay nowDay = MonthDay.of(birDate.getMonthValue(), birDate.getDayOfMonth());
4         //MonthDay monthDay = MonthDay.of(birDate.getMonth(), birDate.getDayOfMonth());
5         MonthDay birDay = MonthDay.from(nowDate);
6         System.out.println("今天是你的生日嗎？ " + nowDay.equals(birDay));//今天是你的生日嗎？ false

 YearMonth表示固定的日期。Year表示年。

1         YearMonth yearMonth = YearMonth.of(2004, 2);
2         System.out.println(yearMonth + "有多少天？ " + yearMonth.lengthOfMonth());//2004-02有多少天？ 29
3         Year year = Year.of(2004);
4         System.out.println(year + "有多少天？ " + year.length());//2004有多少天？ 366
5         System.out.println(year + "是否是閏年？ " + year.isLeap());//2004是否是閏年？ true

新版本的日期時間API中的這幾個類中好多方法都是一樣的作用，使用時可靈活選擇。

回到頂部

對日期時間的修改

LocalDateTime 綜合了 LocalDate 和 LocalTime 裏面的方法，所以下面只用 LocalDate 和 LocalTime 來舉例。

這些方法返回的是一個新的實例引用，因爲LocalDateTime 、LocalDate 、LocalTime 都是不可變的。

 1         LocalDate nowDate = LocalDate.now();
 2         System.out.println(nowDate);//當前日期
 3         System.out.println(nowDate.minusYears(1));//一年前
 4         System.out.println(nowDate.minusMonths(1));//一月前
 5         System.out.println(nowDate.minusWeeks(1));//一週前
 6         System.out.println(nowDate.minusDays(1));//一天前
 7         
 8         System.out.println(nowDate.plusYears(1));//一年後
 9         System.out.println(nowDate.plusMonths(1));//一月後
10         System.out.println(nowDate.plusWeeks(1));//一週後
11         System.out.println(nowDate.plusDays(1));//一天後

 1         LocalTime nowTime = LocalTime.now();
 2         System.out.println(nowTime);//當前時間
 3         System.out.println(nowTime.minusHours(1));//一小時前
 4         System.out.println(nowTime.minusMinutes(1));//一分鐘前
 5         System.out.println(nowTime.minusSeconds(1));//一秒前
 6         System.out.println(nowTime.minusNanos(1));//一納秒前
 7         
 8         System.out.println(nowTime.plusHours(1));//一小時後
 9         System.out.println(nowTime.plusMinutes(1));//一分鐘後
10         System.out.println(nowTime.plusSeconds(1));//一秒後
11         System.out.println(nowTime.plusNanos(1));//一納秒後

還可以直接使用 minus 和 plus 方法來增加和減少日期時間。LocalDateTime 、LocalDate 、LocalTime 都是類似的。

1         System.out.println(nowDate.minus(1, ChronoUnit.YEARS));

1         System.out.println(nowDate.plus(1, ChronoUnit.YEARS));

ChronoUnit 用來表示時間單位， ChronoUnit 後面只需要替換成相應的年、月、周、日、時、分、秒、納秒，就能減少或增加相應的單位。

回到頂部

時間戳

JDK8獲取時間戳特別簡單。Instant類由一個靜態的工廠方法now()可以返回當前時間戳。

1         Instant instant = Instant.now();
2         System.out.println("當前時間戳是：" + instant);//當前時間戳是：2018-09-06T10:14:29.460Z
3         Date date = Date.from(instant);
4         System.out.println("當前時間戳是：" + date);//當前時間戳是：Thu Sep 06 18:14:29 CST 2018
5         instant = date.toInstant();

可以看到，當前時間戳是包含日期和時間的，與java.util.Date很類似，事實上Instant就是JDK8以前的Date，可以使用這兩個類中的方法在這兩個類型之間進行轉換。

回到頂部

日期時間格式化

在JDK8之前，時間日期的格式化非常麻煩，經常使用SimpleDateFormat來進行格式化，但是SimpleDateFormat並不是線程安全的。在JDK8中，引入了一個全新的線程安全的日期與時間格式器DateTimeFormatter。

1         LocalDateTime ldt = LocalDateTime.now();
2         System.out.println(ldt);//2018-09-06T18:22:47.366
3         DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
4         String ldtStr = ldt.format(dtf);
5         System.out.println(ldtStr);//2018-09-06 18:22:47
6         String ldtStr1 = dtf.format(ldt);
7         System.out.println(ldtStr1);//2018-09-06 18:22:47

正反都能調用format方法。

回到頂部

計算日期時間差

在Java8中，我們可以使用以下類來計算日期時間差異：

java.time.Period

主要是 Period 類方法 getYears()，getMonths() 和 getDays() 來計算。只能精確到年月日。

用於 LocalDate 之間的比較。

1         LocalDate today = LocalDate.now();
2         System.out.println(today);//2018-09-06
3         LocalDate birthDate = LocalDate.of(1992, 1, 11);
4         System.out.println(birthDate);//1990-10-01
5         
6         Period period = Period.between(birthDate, today);//第二個參數減第一個參數
7         System.out.printf("年齡 : %d 年 %d 月 %d 日", period.getYears(), period.getMonths(), period.getDays());//年齡 : 27 年 11 月 5 日

java.time.Duration

提供了使用基於時間的值測量時間量的方法。

用於 LocalDateTime 之間的比較。也可用於 Instant 之間的比較。

 1         LocalDateTime today = LocalDateTime.now();
 2         System.out.println(today);
 3         LocalDateTime birthDate = LocalDateTime.of(1990,10,1,10,50,30);
 4         System.out.println(birthDate);
 5         
 6         Duration duration = Duration.between(birthDate, today);//第二個參數減第一個參數
 7         System.out.println(duration.toDays());//兩個時間差的天數
 8         System.out.println(duration.toHours());//兩個時間差的小時數
 9         System.out.println(duration.toMinutes());//兩個時間差的分鐘數
10         System.out.println(duration.toMillis());//兩個時間差的毫秒數
11         System.out.println(duration.toNanos());//兩個時間差的納秒數

java.time.temporal.ChronoUnit

ChronoUnit類可用於在單個時間單位內測量一段時間，這個工具類是最全的了，可以用於比較所有的時間單位。

 1         LocalDateTime today = LocalDateTime.now();
 2         System.out.println(today);
 3         LocalDateTime birthDate = LocalDateTime.of(1990,10,1,10,50,30);
 4         System.out.println(birthDate);
 5         
 6         System.out.println("相差的年數：" + ChronoUnit.YEARS.between(birthDate, today));
 7         System.out.println("相差的月數：" + ChronoUnit.MONTHS.between(birthDate, today));
 8         System.out.println("相差的週數：" + ChronoUnit.WEEKS.between(birthDate, today));
 9         System.out.println("相差的天數：" + ChronoUnit.DAYS.between(birthDate, today));
10         System.out.println("相差的時數：" + ChronoUnit.HOURS.between(birthDate, today));
11         System.out.println("相差的分數：" + ChronoUnit.MINUTES.between(birthDate, today));
12         System.out.println("相差的秒數：" + ChronoUnit.SECONDS.between(birthDate, today));
13         System.out.println("相差的毫秒數：" + ChronoUnit.MILLIS.between(birthDate, today));
14         System.out.println("相差的微秒數：" + ChronoUnit.MICROS.between(birthDate, today));
15         System.out.println("相差的納秒數：" + ChronoUnit.NANOS.between(birthDate, today));
16         
17         System.out.println("相差的半天數：" + ChronoUnit.HALF_DAYS.between(birthDate, today));
18         System.out.println("相差的十年數：" + ChronoUnit.DECADES.between(birthDate, today));
19         System.out.println("相差的世紀（百年）數：" + ChronoUnit.CENTURIES.between(birthDate, today));
20         System.out.println("相差的千年數：" + ChronoUnit.MILLENNIA.between(birthDate, today));
21         System.out.println("相差的紀元數：" + ChronoUnit.ERAS.between(birthDate, today));