背景
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));