JDK1.8-新的日期和時間API

Java的API提供了不少有用的組件，能幫助你構建複雜的應用。不過，Java API也不老是完美的。咱們相信大多數有經驗的程序員都會贊同Java 8以前的庫對日期和時間的支持就很是不理想。然而，你也不用太擔憂：Java 8中引入全新的日期和時間API就是要解決這一問題。

1 LocalDate 、 LocalTime 、 Instant 、 Duration 以及 Period

讓咱們從探索如何建立簡單的日期和時間間隔入手。 java.time 包中提供了不少新的類能夠幫你解決問題，它們是 LocalDate 、 LocalTime 、 Instant 、 Duration 和 Period 。

1.1 LocalDate 和 LocalTime

LocalDate 類，該類的實例是一個不可變對象，它只提供了簡單的日期，並不含當天的時間信息。另外，它也不附帶任何與時區相關的信息。

你能夠經過靜態工廠方法 of 建立一個 LocalDate 實例。 LocalDate 實例提供了多種方法來讀取經常使用的值，好比年份、月份、星期幾等。

public static void main(String[] args) {
        //2014-3-18
        LocalDate date = LocalDate.of(2014, 3, 18);
        //2014
        int year = date.getYear();
        //march
        Month month = date.getMonth();
        //18
        int day = date.getDayOfMonth();
        DayOfWeek dow = date.getDayOfWeek();
        //這個月的天數
        int len = date.lengthOfMonth();
        //是否事閏年
        boolean leap = date.isLeapYear();
        System.out.println("year : " + year + " month : " + month + " day : " + day +
                " dow : " + dow + " len : " + len + " leap : " + leap);
    }

複製代碼

似地，一天中的時間，好比13:45:20，可使用 LocalTime 類表示。你可使用 of 重載的兩個工廠方法建立 LocalTime 的實例。第一個重載函數接收小時和分鐘，第二個重載函數同時還接收秒。同 LocalDate 同樣， LocalTime 類也提供了一些 getter 方法訪問這些變量的值。

LocalTime time = LocalTime.of(13, 45, 20);
int hour = time.getHour();
int minute = time.getMinute();
int second = time.getSecond();
複製代碼

LocalDate 和 LocalTime 均可以經過解析表明它們的字符串建立。使用靜態方法 parse ，你能夠實現這一目的:

LocalDate date = LocalDate.parse("2014-03-18");
LocalTime time = LocalTime.parse("13:45:20");
複製代碼

1.2 合併日期和時間

這個複合類名叫 LocalDateTime ，是 LocalDate 和 LocalTime 的合體。它同時表示了日期和時間，但不帶有時區信息，你能夠直接建立，也能夠經過合併日期和時間對象構造。

// 2014-03-18T13:45:20
LocalDateTime dt1 = LocalDateTime.of(2014, Month.MARCH, 18, 13, 45, 20);
LocalDateTime dt2 = LocalDateTime.of(date, time);
LocalDateTime dt3 = date.atTime(13, 45, 20);
LocalDateTime dt4 = date.atTime(time);
LocalDateTime dt5 = time.atDate(date);
複製代碼

經過它們各自的 atTime 或者 atDate 方法，向 LocalDate 傳遞一個時間對象，或者向LocalTime 傳遞一個日期對象的方式，你能夠建立一個 LocalDateTime 對象。你也可使用toLocalDate 或者 toLocalTime 方法，從 LocalDateTime 中提取 LocalDate 或者 LocalTime組件:

LocalDate date1 = dt1.toLocalDate();
LocalTime time1 = dt1.toLocalTime();
複製代碼

1.3 Duration 和 Period

Duration 類的靜態工廠方法 between 就是爲比較兩個時間而設計的。你能夠建立兩個 LocalTimes 對象、兩個 LocalDateTimes對象，或者兩個 Instant 對象之間的 duration：

Duration d1 = Duration.between(time1, time2);
Duration d1 = Duration.between(dateTime1, dateTime2);
複製代碼

若是你須要以年、月或者日的方式對多個時間單位建模，可使用 Period 類。使用該類的工廠方法 between ，你可使用獲得兩個 LocalDate 之間的時長:

Period tenDays = Period.between(LocalDate.of(2014, 3, 8),
								LocalDate.of(2014, 3, 18));
複製代碼

最後， Duration 和 Period 類都提供了不少很是方便的工廠類，直接建立對應的實例；換句話說，就像下面這段代碼那樣，再也不是隻能以兩個temporal對象的差值的方式來定義它們的對象。

Duration threeMinutes = Duration.ofMinutes(3);
Duration threeMinutes = Duration.of(3, ChronoUnit.MINUTES);
Period tenDays = Period.ofDays(10);
Period threeWeeks = Period.ofWeeks(3);
Period twoYearsSixMonthsOneDay = Period.of(2, 6, 1);
複製代碼

Duration 類和 Period 類共享方法

2 操縱、解析和格式化日期

2.1 比較直觀的方式操縱 LocalDate 的屬性

//2019-3-20
        LocalDate of = LocalDate.of(2019, 3, 20);
        //2018-3-20
        LocalDate localDate = of.withYear(2018);
        //2018-4-20
        LocalDate localDate1 = localDate.withMonth(4);
        //2018-9-20
        LocalDate with = localDate1.with(ChronoField.MONTH_OF_YEAR, 9);
複製代碼

最後這一行中使用的 with 方法和get方法有些相似，它們都聲明於 Temporal 接口，全部的日期和時間API類都實現這兩個方法，它們定義了單點的時間，好比 LocalDate 、 LocalTime 、 LocalDateTime 以及 Instant 。更確切 地說，使用 get 和 with 方法，咱們能夠將 Temporal 對象值的讀取和修改區分開。

2.2 以相對方式修改 LocalDate 對象的屬性

//2014-3-18
LocalDate date1 = LocalDate.of(2014, 3, 18);
//2014-3-25
LocalDate date2 = date1.plusWeeks(1);

LocalDate date3 = date2.minusYears(3);
LocalDate date4 = date3.plus(6, ChronoUnit.MONTHS);
複製代碼

最後一行使用的 plus 方法也是通用方法，它和 minus 方法都聲明於 Temporal 接口中。經過這些方法，對 TemporalUnit 對象加上或者減去一個數字，咱們能很是方便地將 Temporal 對象前溯或者回滾至某個時間段，經過ChronoUnit 枚舉咱們能夠很是方便地實現 TemporalUnit 接口。

2.3 使用 TemporalAdjuster

有的時候，你須要進行一些更加複雜的操做，好比，將日期調整到下個週日、下個工做日，或者是本月的最後一天。這時，你可使用重載版本的 with 方法，向其傳遞一個提供了更多定製化選擇的 TemporalAdjuster 對象，更加靈活地處理日期。對於最多見的用例，日期和時間API已經提供了大量預約義的TemporalAdjuster 。你能夠經過 TemporalAdjuster 類的靜態工廠方法訪問它們。

//2014-03-18
LocalDate date1 = LocalDate.of(2014, 3, 18);
//2014-03-23
LocalDate date2 = date1.with(nextOrSame(DayOfWeek.SUNDAY));
//2014-03-31
LocalDate date3 = date2.with(lastDayOfMonth());
複製代碼

正如咱們看到的，使用 TemporalAdjuster 咱們能夠進行更加複雜的日期操做，並且這些方 法的名稱也很是直觀，方法名基本就是問題陳述。此外，即便你沒有找到符合你要求的預約義的 TemporalAdjuster ，建立你本身的 TemporalAdjuster 也並不是難事。實際上， Temporal- Adjuster 接口只聲明瞭單一的一個方法（這使得它成爲了一個函數式接口）。

@FunctionalInterface
public interface TemporalAdjuster {
	Temporal adjustInto(Temporal temporal);
}
複製代碼

這意味着 TemporalAdjuster 接口的實現須要定義如何將一個 Temporal 對象轉換爲另外一個 Temporal 對象。你能夠把它當作一個 UnaryOperator

2.4 實現一個定製的 TemporalAdjuster

設計一個 NextWorkingDay 類，該類實現了 TemporalAdjuster 接口，可以計算明天的日期，同時過濾掉週六和週日這些節假日。格式以下所示：

public class MyTemporalAdjuster {
    public static void main(String[] args) {
        LocalDate of = LocalDate.of(2019, 3, 20);
        LocalDate with = of.with(new NewTemporalAdjuster());
        System.out.println("with = " + with);
    }
}

//若是當天的星期介於週一至週五之間，日期向後移動一天；若是當天是週六或者週日，則返回下一個週一
class  NewTemporalAdjuster implements TemporalAdjuster {
    @Override
    public Temporal adjustInto(Temporal temporal) {
        DayOfWeek of = DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));
        int dayToAdd = 1;
        if (of == DayOfWeek.FRIDAY){
            dayToAdd = 3;
        }else if (of == DayOfWeek.SATURDAY){
            dayToAdd = 2;
        }
        return temporal.plus(dayToAdd, ChronoUnit.DAYS);
    }
}
複製代碼

2.5 打印輸出及解析日期--時間對象

處理日期和時間對象時，格式化以及解析日期時間對象是另外一個很是重要的功能。新的java.time.format 包就是特別爲這個目的而設計的。這個包中，最重要的類是 DateTimeFormatter 。建立格式器最簡單的方法是經過它的靜態工廠方法以及常量。像 BASIC_ISO_DATE和 ISO_LOCAL_DATE 這 樣 的 常 量 是 DateTimeFormatter 類 的 預 定 義 實 例 。 所 有 的DateTimeFormatter 實例都能用於以必定的格式建立表明特定日期或時間的字符串。

LocalDate date = LocalDate.of(2014, 3, 18);
//20140318
String s1 = date.format(DateTimeFormatter.BASIC_ISO_DATE);
//2014-03-18
String s2 = date.format(DateTimeFormatter.ISO_LOCAL_DATE);
複製代碼

你也能夠經過解析表明日期或時間的字符串從新建立該日期對象。全部的日期和時間API都提供了表示時間點或者時間段的工廠方法，你可使用工廠方法 parse 達到重創該日期對象的目的：

LocalDate date1 = LocalDate.parse("20140318",DateTimeFormatter.BASIC_ISO_DATE);
LocalDate date2 = LocalDate.parse("2014-03-18",DateTimeFormatter.ISO_LOCAL_DATE);
複製代碼

2.6 按照某個模式建立 DateTimeFormatter

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate date1 = LocalDate.of(2014, 3, 18);
String formattedDate = date1.format(formatter);
LocalDate date2 = LocalDate.parse(formattedDate, formatter);
複製代碼

LocalDate 的 formate 方法使用指定的模式生成了一個表明該日期的字符串。