為什麼不建議使用Date,而是使用Java8新的時間和日期API?
- 2019 年 10 月 3 日
- 筆記
Java 8:新的時間和日期API
在Java 8之前,所有關於時間和日期的API都存在各種使用方面的缺陷,因此建議使用新的時間和日期API,分別從舊的時間和日期的API的缺點以及解決方法、Java 8 新的時間和日期API進行講解。
舊的時間和日期的API的缺陷
Java 的 java.util.Date 和 java.util.Calendar 類易用性差,不支援時區,而且都不是執行緒安全的。
Date如果不格式化,列印出的日期可讀性差。
Thu Sep 12 13:47:34 CST 2019
可以使用 SimpleDateFormat 對時間進行格式化,但 SimpleDateFormat 是執行緒不安全的,SimpleDateFormat 的 format 方法源碼如下:
private StringBuffer format(Date date, StringBuffer toAppendTo, FieldDelegate delegate) { // Convert input date to time field list calendar.setTime(date); boolean useDateFormatSymbols = useDateFormatSymbols(); for (int i = 0; i < compiledPattern.length; ) { int tag = compiledPattern[i] >>> 8; int count = compiledPattern[i++] & 0xff; if (count == 255) { count = compiledPattern[i++] << 16; count |= compiledPattern[i++]; } switch (tag) { case TAG_QUOTE_ASCII_CHAR: toAppendTo.append((char)count); break; case TAG_QUOTE_CHARS: toAppendTo.append(compiledPattern, i, count); i += count; break; default: subFormat(tag, count, delegate, toAppendTo, useDateFormatSymbols); break; } } return toAppendTo; }
其中 calendar 是共享變數,並且這個共享變數沒有做執行緒安全控制。當多個執行緒同時使用相同的 SimpleDateFormat 對象【如用static修飾的 SimpleDateFormat 】調用format方法時,多個執行緒會同時調用 calendar.setTime 方法,可能一個執行緒剛設置好 time 值另外的一個執行緒馬上把設置的 time 值給修改了導致返回的格式化時間可能是錯誤的。
在多並發情況下使用 SimpleDateFormat 需注意。
SimpleDateFormat 除了 format 是執行緒不安全以外,parse 方法也是執行緒不安全的。parse 方法實際調用 alb.establish(calendar).getTime() 方法來解析,alb.establish(calendar) 方法里主要完成了
- 重置日期對象cal的屬性值
- 使用calb中中屬性設置cal
- 返回設置好的cal對象
但是這三步不是原子操作,導致解析出來的時間可以是錯誤的。
Date對時間處理比較麻煩,比如想獲取某年、某月、某星期,以及 n 天以後的時間,如果用Date來處理的話真是太難了,並且 Date 類的 getYear、getMonth 這些方法都被棄用了。
多執行緒並發如何保證執行緒安全
避免執行緒之間共享一個 SimpleDateFormat 對象,每個執行緒使用時都創建一次 SimpleDateFormat 對象 => 創建和銷毀對象的開銷大
對使用 format 和 parse 方法的地方進行加鎖 => 執行緒阻塞性能差
使用 ThreadLocal 保證每個執行緒最多只創建一次 SimpleDateFormat 對象 => 較好的方法
Java 8 新的時間和日期API
Java 8的日期和時間類包含 LocalDate、LocalTime、Instant、Duration 以及 Period,這些類都包含在 java.time 包中,Java 8 新的時間API的使用方式,包括創建、格式化、解析、計算、修改,下面我們看下如何去使用。
LocalDate 只會獲取年月日
// 創建 LocalDate // 獲取當前年月日 LocalDate localDate = LocalDate.now(); // 構造指定的年月日 LocalDate localDate1 = LocalDate.of(2019, 9, 12); // 獲取年、月、日、星期幾 int year = localDate.getYear(); int year1 = localDate.get(ChronoField.YEAR); Month month = localDate.getMonth(); int month1 = localDate.get(ChronoField.MONTH_OF_YEAR); int day = localDate.getDayOfMonth(); int day1 = localDate.get(ChronoField.DAY_OF_MONTH); DayOfWeek dayOfWeek = localDate.getDayOfWeek(); int dayOfWeek1 = localDate.get(ChronoField.DAY_OF_WEEK);
LocalTime 只會獲取時分秒
// 創建 LocalTime LocalTime localTime = LocalTime.of(14, 14, 14); LocalTime localTime1 = LocalTime.now(); // 獲取小時 int hour = localTime.getHour(); int hour1 = localTime.get(ChronoField.HOUR_OF_DAY); // 獲取分 int minute = localTime.getMinute(); int minute1 = localTime.get(ChronoField.MINUTE_OF_HOUR); // 獲取秒 int second = localTime.getMinute(); int second1 = localTime.get(ChronoField.SECOND_OF_MINUTE);
LocalDateTime 獲取年月日時分秒,相當於 LocalDate + LocalTime
// 創建 LocalDateTime LocalDateTime localDateTime = LocalDateTime.now(); LocalDateTime localDateTime1 = LocalDateTime.of(2019, Month.SEPTEMBER, 10, 14, 46, 56); LocalDateTime localDateTime2 = LocalDateTime.of(localDate, localTime); LocalDateTime localDateTime3 = localDate.atTime(localTime); LocalDateTime localDateTime4 = localTime.atDate(localDate); // 獲取LocalDate LocalDate localDate2 = localDateTime.toLocalDate(); // 獲取LocalTime LocalTime localTime2 = localDateTime.toLocalTime();
Instant 獲取秒數,用於表示一個時間戳(精確到納秒)
如果只是為了獲取秒數或者毫秒數,可以使用 System.currentTimeMillis()。
// 創建Instant對象 Instant instant = Instant.now(); // 獲取秒數 long currentSecond = instant.getEpochSecond(); // 獲取毫秒數 long currentMilli = instant.toEpochMilli();
Duration 表示一個時間段
// Duration.between()方法創建 Duration 對象 LocalDateTime from = LocalDateTime.of(2017, Month.JANUARY, 1, 00, 0, 0); // 2017-01-01 00:00:00 LocalDateTime to = LocalDateTime.of(2019, Month.SEPTEMBER, 12, 14, 28, 0); // 2019-09-15 14:28:00 Duration duration = Duration.between(from, to); // 表示從 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(); // 這段時間的納秒數
修改 LocalDate、LocalTime、LocalDateTime、Instant。
LocalDate、LocalTime、LocalDateTime、Instant 為不可變對象,修改這些對象對象會返回一個副本。
增加、減少年數、月數、天數等,以LocalDateTime為例:
LocalDateTime localDateTime = LocalDateTime.of(2019, Month.SEPTEMBER, 12, 14, 32, 0); // 增加一年 localDateTime = localDateTime.plusYears(1); localDateTime = localDateTime.plus(1, ChronoUnit.YEARS); // 減少一個月 localDateTime = localDateTime.minusMonths(1); localDateTime = localDateTime.minus(1, ChronoUnit.MONTHS); // 通過with修改某些值 // 修改年為2020 localDateTime = localDateTime.withYear(2020); localDateTime = localDateTime.with(ChronoField.YEAR, 2020); // 時間計算 // 獲取該年的第一天 LocalDate localDate = LocalDate.now(); LocalDate localDate1 = localDate.with(firstDayOfYear());
TemporalAdjusters 包含許多靜態方法,可以直接調用,以下列舉一些:
方法名 | 描述 |
---|---|
dayOfWeekInMonth | 返回同一個月中每周的第幾天 |
firstDayOfMonth | 返回當月的第一天 |
firstDayOfNextMonth | 返回下月的第一天 |
firstDayOfNextYear | 返回下一年的第一天 |
firstDayOfYear | 返回本年的第一天 |
firstInMonth | 返回同一個月中第一個星期幾 |
lastDayOfMonth | 返回當月的最後一天 |
lastDayOfNextMonth | 返回下月的最後一天 |
lastDayOfNextYear | 返回下一年的最後一天 |
lastDayOfYear | 返回本年的最後一天 |
lastInMonth | 返回同一個月中最後一個星期幾 |
next / previous | 返回後一個/前一個給定的星期幾 |
nextOrSame / previousOrSame | 返回後一個/前一個給定的星期幾,如果這個值滿足條件,直接返回 |
格式化時間
LocalDate localDate = LocalDate.of(2019, 9, 12); String s1 = localDate.format(DateTimeFormatter.BASIC_ISO_DATE); String s2 = localDate.format(DateTimeFormatter.ISO_LOCAL_DATE); // 自定義格式化 DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd"); String s3 = localDate.format(dateTimeFormatter);
解析時間
LocalDate localDate1 = LocalDate.parse("20190912", DateTimeFormatter.BASIC_ISO_DATE); LocalDate localDate2 = LocalDate.parse("2019-09-12", DateTimeFormatter.ISO_LOCAL_DATE);
總結
和 SimpleDateFormat 相比,DateTimeFormatter 是執行緒安全的。
Instant 的精確度更高,可以精確到納秒級。
Duration 可以便捷得到時間段內的天數、小時數等。
LocalDateTime 能夠快速地獲取年、月、日、下一月等。
TemporalAdjusters 類中包含許多常用的靜態方法,避免自己編寫工具類。