時間日期API · Java8 簡明教程

# 時間日期API Java 8 包含了全新的時間日期API，這些功能都放在了java.time包下。新的時間日期API是基于Joda-Time庫開發的，但是也不盡相同。下面的例子就涵蓋了大多數新的API的重要部分。 #### Clock Clock提供了對當前時間和日期的訪問功能。Clock是對當前時區敏感的，并可用于替代System.currentTimeMillis()方法來獲取當前的毫秒時間。當前時間線上的時刻可以用Instance類來表示。Instance也能夠用于創建原先的java.util.Date對象。 ``` Clock clock = Clock.systemDefaultZone(); long millis = clock.millis(); Instant instant = clock.instant(); Date legacyDate = Date.from(instant); // legacy java.util.Date ``` #### Timezones 時區類可以用一個ZoneId來表示。時區類的對象可以通過靜態工廠方法方便地獲取。時區類還定義了一個偏移量，用來在當前時刻或某時間與目標時區時間之間進行轉換。 ``` System.out.println(ZoneId.getAvailableZoneIds()); // prints all available timezone ids ZoneId zone1 = ZoneId.of("Europe/Berlin"); ZoneId zone2 = ZoneId.of("Brazil/East"); System.out.println(zone1.getRules()); System.out.println(zone2.getRules()); // ZoneRules[currentStandardOffset=+01:00] // ZoneRules[currentStandardOffset=-03:00] ``` #### LocalTime 本地時間類表示一個沒有指定時區的時間，例如，10 p.m.或者17：30:15，下面的例子會用上面的例子定義的時區創建兩個本地時間對象。然后我們會比較兩個時間，并計算它們之間的小時和分鐘的不同。 ``` LocalTime now1 = LocalTime.now(zone1); LocalTime now2 = LocalTime.now(zone2); System.out.println(now1.isBefore(now2)); // false long hoursBetween = ChronoUnit.HOURS.between(now1, now2); long minutesBetween = ChronoUnit.MINUTES.between(now1, now2); System.out.println(hoursBetween); // -3 System.out.println(minutesBetween); // -239 ``` LocalTime是由多個工廠方法組成，其目的是為了簡化對時間對象實例的創建和操作，包括對時間字符串進行解析的操作。 ``` LocalTime late = LocalTime.of(23, 59, 59); System.out.println(late); // 23:59:59 DateTimeFormatter germanFormatter = DateTimeFormatter .ofLocalizedTime(FormatStyle.SHORT) .withLocale(Locale.GERMAN); LocalTime leetTime = LocalTime.parse("13:37", germanFormatter); System.out.println(leetTime); // 13:37 ``` #### LocalDate 本地時間表示了一個獨一無二的時間，例如：2014-03-11。這個時間是不可變的，與LocalTime是同源的。下面的例子演示了如何通過加減日，月，年等指標來計算新的日期。記住，每一次操作都會返回一個新的時間對象。 ``` LocalDate today = LocalDate.now(); LocalDate tomorrow = today.plus(1, ChronoUnit.DAYS); LocalDate yesterday = tomorrow.minusDays(2); LocalDate independenceDay = LocalDate.of(2014, Month.JULY, 4); DayOfWeek dayOfWeek = independenceDay.getDayOfWeek(); System.out.println(dayOfWeek); // FRIDAY<span style="font-family: Georgia, 'Times New Roman', 'Bitstream Charter', Times, serif; font-size: 13px; line-height: 19px;">Parsing a LocalDate from a string is just as simple as parsing a LocalTime:</span> ``` 解析字符串并形成LocalDate對象，這個操作和解析LocalTime一樣簡單。 ``` DateTimeFormatter germanFormatter = DateTimeFormatter .ofLocalizedDate(FormatStyle.MEDIUM) .withLocale(Locale.GERMAN); LocalDate xmas = LocalDate.parse("24.12.2014", germanFormatter); System.out.println(xmas); // 2014-12-24 ``` #### LocalDateTime LocalDateTime表示的是日期-時間。它將剛才介紹的日期對象和時間對象結合起來，形成了一個對象實例。LocalDateTime是不可變的，與LocalTime和LocalDate的工作原理相同。我們可以通過調用方法來獲取日期時間對象中特定的數據域。 ``` LocalDateTime sylvester = LocalDateTime.of(2014, Month.DECEMBER, 31, 23, 59, 59); DayOfWeek dayOfWeek = sylvester.getDayOfWeek(); System.out.println(dayOfWeek); // WEDNESDAY Month month = sylvester.getMonth(); System.out.println(month); // DECEMBER long minuteOfDay = sylvester.getLong(ChronoField.MINUTE_OF_DAY); System.out.println(minuteOfDay); // 1439 ``` 如果再加上的時區信息，LocalDateTime能夠被轉換成Instance實例。Instance能夠被轉換成以前的java.util.Date對象。 ``` Instant instant = sylvester .atZone(ZoneId.systemDefault()) .toInstant(); Date legacyDate = Date.from(instant); System.out.println(legacyDate); // Wed Dec 31 23:59:59 CET 2014 ``` 格式化日期-時間對象就和格式化日期對象或者時間對象一樣。除了使用預定義的格式以外，我們還可以創建自定義的格式化對象，然后匹配我們自定義的格式。 ``` DateTimeFormatter formatter = DateTimeFormatter .ofPattern("MMM dd, yyyy - HH:mm"); LocalDateTime parsed = LocalDateTime.parse("Nov 03, 2014 - 07:13", formatter); String string = formatter.format(parsed); System.out.println(string); // Nov 03, 2014 - 07:13 ``` 不同于java.text.NumberFormat，新的DateTimeFormatter類是不可變的，也是線程安全的。更多的細節，請看[這里](http://download.java.net/jdk8/docs/api/java/time/format/DateTimeFormatter.html)