JAVA中計算兩個日期時間的差值竟然也有這麼多門道

上半年春招的時候，作為面試官，對於面試表現的不錯的同學會要求其寫一小段代碼看看。題目很簡單：

給定一個日期，然後計算下距離今天相差的天數。

本以為這麼個問題就是用來活躍面試氛圍的，但是結果卻讓人大跌眼鏡，真正能寫出來的人竟然寥寥無幾，很多人寫了一整張A4紙都寫不下，最後還是沒寫完...他們在做什麼？

先取出今天的日期，然後分別計算得出年、月、日的值，然後將給定的字元串進行切割，得到目標的年、月、日，然後再判斷是否閏年之類的邏輯，決定每月應該是加28天還是29天還是30或者31天，最後得出一個天數！

想想都令人窒息的操作...

日期時間的處理，是軟體開發中極其常見的場景，JAVA中與日期、時間相關的一些類與API方法也很多，這裡結合平時的編碼實踐全面的整理了下，希望可以幫助大家釐清其中的門道，更加游刃有餘的面對此方面的處理~

JAVA中與日期時間相關的類

java.util包中

java.time包中

JAVA8之後新增了java.time包，提供了一些與日期時間有關的新實現類：

具體每個類對應的含義說明梳理如下表：

時間間隔計算

Period與Duration類

JAVA8開始新增的java.time包中有提供Duration和Period兩個類，用於處理日期時間間隔相關的場景，兩個類的區別點如下：

Duration與Period具體使用的時候還需要有一定的甄別，因為部分的方法很容易使用中被混淆，下麵分別說明下。

• Duration

Duration的最小計數單位為納秒，其內部使用seconds和nanos兩個欄位來進行組合計數表示duration總長度。

Duration的常用API方法梳理如下：

關於Duration的主要API的使用，參見如下示意：

public void testDuration() {
    LocalTime target = LocalTime.parse("00:02:35.700");
    // 獲取當前日期，此處為了保證後續結果固定，註掉自動獲取當前日期，指定固定日期
    // LocalDate today = LocalDate.now();
    LocalTime today = LocalTime.parse("12:12:25.600");
    // 輸出：12:12:25.600
    System.out.println(today);
    // 輸出：00:02:35.700
    System.out.println(target);
    Duration duration = Duration.between(target, today);
    // 輸出：PT12H9M49.9S
    System.out.println(duration);
    // 輸出：43789
    System.out.println(duration.getSeconds());
    // 輸出：900000000
    System.out.println(duration.getNano());
    // 輸出：729
    System.out.println(duration.toMinutes());
    // 輸出：PT42H9M49.9S
    System.out.println(duration.plusHours(30L));
    // 輸出：PT15.9S
    System.out.println(duration.withSeconds(15L));
}

• Period

Period相關介面與Duration類似，其計數的最小單位是天，看下Period內部時間段記錄採用了年、月、日三個field來記錄：

常用的API方法列舉如下：

關於Period的主要API的使用，參見如下示意：

public void calculateDurationDays() {
    LocalDate target = LocalDate.parse("2021-07-11");
    // 獲取當前日期，此處為了保證後續結果固定，註掉自動獲取當前日期，指定固定日期
    // LocalDate today = LocalDate.now();
    LocalDate today = LocalDate.parse("2022-07-08");
    // 輸出：2022-07-08
    System.out.println(today);
    // 輸出：2021-07-11
    System.out.println(target);
    Period period = Period.between(target, today);
    // 輸出：P11M27D， 表示11個月27天
    System.out.println(period);
    // 輸出：0， 因為period值為11月27天，即year欄位為0
    System.out.println(period.getYears());
    // 輸出：11， 因為period值為11月27天，即month欄位為11
    System.out.println(period.getMonths());
    // 輸出：27， 因為period值為11月27天，即days欄位為27
    System.out.println(period.getDays());
    // 輸出：P14M27D， 因為period為11月27天，加上3月，變成14月27天
    System.out.println(period.plusMonths(3L));
    // 輸出：P11M15D，因為period為11月27天，僅將days值設置為15，則變為11月15天
    System.out.println(period.withDays(15));
    // 輸出：P2Y3M44D
    System.out.println(Period.of(2, 3, 44));
}

Duration與Period踩坑記

Duration與Period都是用於日期之間的計算操作。Duration主要用於秒、納秒等維度的數據處理與計算。Period主要用於計算年、月、日等維度的數據處理與計算。

先看個例子，計算兩個日期相差的天數，使用Duration的時候：

public void calculateDurationDays(String targetDate) {
    LocalDate target = LocalDate.parse(targetDate);
    LocalDate today = LocalDate.now();
    System.out.println("today : " + today);
    System.out.println("target: " + target);
    long days = Duration.between(target, today).abs().toDays();
    System.out.println("相差："  + days + "天");
}

運行後會報錯：

today : 2022-07-07
target: 2022-07-11
Exception in thread "main" java.time.temporal.UnsupportedTemporalTypeException: Unsupported unit: Seconds
	at java.time.LocalDate.until(LocalDate.java:1614)
	at java.time.Duration.between(Duration.java:475)
	at com.veezean.demo5.DateService.calculateDurationDays(DateService.java:24)

點擊看下Duration.between源碼，可以看到註釋上明確有標註著，這個方法是用於秒級的時間段間隔計算，而我們這裡傳入的是兩個天級別的數據，所以就不支持此類型運算，然後拋異常了。

再看下使用Period的實現：

public void calculateDurationDays(String targetDate) {
    LocalDate target = LocalDate.parse(targetDate);
    LocalDate today = LocalDate.now();
    System.out.println("today : " + today);
    System.out.println("target: " + target);
    // 註意，此處寫法錯誤！這裡容易踩坑：
    long days = Math.abs(Period.between(target, today).getDays());
    System.out.println("相差："  + days + "天");
}

執行結果：

today : 2022-07-07
target: 2021-07-07
相差：0天

執行是不報錯，但是結果明顯是錯誤的。這是因為getDays()並不會將Period值換算為天數，而是單獨計算年、月、日，此處只是返回天數這個單獨的值。

再看下麵的寫法：

public void calculateDurationDays(String targetDate) {
    LocalDate target = LocalDate.parse(targetDate);
    LocalDate today = LocalDate.now();
    System.out.println("today : " + today);
    System.out.println("target: " + target);
    Period between = Period.between(target, today);
    System.out.println("相差："
            + Math.abs(between.getYears()) + "年"
            + Math.abs(between.getMonths()) + "月"
            + Math.abs(between.getDays()) + "天");
}

結果為：

today : 2022-07-07
target: 2021-07-11
相差：0年11月26天

所以說，如果想要計算兩個日期之間相差的絕對天數，用Period不是一個好的思路。

計算日期差

• 通過LocalDate來計算

LocalDate中的toEpocDay可返回當前時間距離原點時間之間的天數，可以基於這一點，來實現計算兩個日期之間相差的天數：

代碼如下：

public void calculateDurationDays(String targetDate) {
    LocalDate target = LocalDate.parse(targetDate);
    LocalDate today = LocalDate.now();
    System.out.println("today : " + today);
    System.out.println("target: " + target);
    long days = Math.abs(target.toEpochDay() - today.toEpochDay());
    System.out.println("相差：" + days + "天");
}

結果為：

today : 2022-07-07
target: 2021-07-11
相差：361天

• 通過時間戳來計算

如果是使用的Date對象，則可以通過將Date日期轉換為毫秒時間戳的方式相減然後將毫秒數轉為天數的方式來得到結果。需要註意的是通過毫秒數計算日期天數的差值時，需要屏蔽掉時分秒帶來的誤差影響。

public void calculateDaysGap(Date start, Date end) {
    final long ONE_DAY_MILLIS = 1000L * 60 * 60 * 24;
    // 此處要註意，去掉時分秒的差值影響，此處採用先換算為天再相減的方式
    long gapDays = Math.abs(end.getTime()/ONE_DAY_MILLIS - start.getTime()/ONE_DAY_MILLIS);
    System.out.println(gapDays);
}

輸出結果：

today : 2022-07-08
target: 2021-07-11
相差：362天

• 數學邏輯計算

分別算出年、月、日差值，然後根據是否閏年、每月是30還是31天等計數邏輯，純數學硬懟方式計算。

不推薦、代碼略...

計算介面處理耗時

在一些性能優化的場景中，我們需要獲取到方法處理的執行耗時，很多人都是這麼寫的：

public void doSomething() {
    // 記錄開始時間戳
    long startMillis = System.currentTimeMillis();
    // do something ...
    
    // 計算結束時間戳
    long endMillis = System.currentTimeMillis();
    
    // 計算相差的毫秒數
    System.out.println(endMillis - startMillis);
}

當然啦，如果你使用的是JDK8+的版本，你還可以這麼寫：

public void doSomething() {
    // 記錄開始時間戳
    Instant start = Instant.now();
    // do something ...

    // 計算結束時間戳
    Instant end = Instant.now();

    // 計算相差的毫秒數
    System.out.println(Duration.between(start, end).toMillis());
}

時間格式轉換

項目中，時間格式轉換是一個非常典型的日期處理操作，可能會涉及到將一個字元串日期轉換為JAVA對象，或者是將一個JAVA日期對象轉換為指定格式的字元串日期時間。

SimpleDataFormat實現

在JAVA8之前，通常會使用SimpleDateFormat類來處理日期與字元串之間的相互轉換：

public void testDateFormatter() {
    SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    // 日期轉字元串
    String format = simpleDateFormat.format(new Date());
    System.out.println("當前時間：" + format);
   
    try {
        // 字元串轉日期
        Date parseDate = simpleDateFormat.parse("2022-07-08 06:19:27");
        System.out.println("轉換後Date對象： " + parseDate);
        // 按照指定的時區進行轉換，可以對比下前面轉換後的結果，會發現不一樣
        simpleDateFormat.setTimeZone(TimeZone.getTimeZone("GMT+5:00"));
        parseDate = simpleDateFormat.parse("2022-07-08 06:19:27");
        System.out.println("指定時區轉換後Date對象： " + parseDate);
    } catch (Exception e) {
        e.printStackTrace();
    }
}

輸出結果如下：

當前時間：2022-07-08 06:25:31
轉換後Date對象： Fri Jul 08 06:19:27 CST 2022
指定時區轉換後Date對象： Fri Jul 08 09:19:27 CST 2022

補充說明：

SimpleDateFormat對象是非線程安全的，所以項目中在封裝為工具方法使用的時候需要特別留意，最好結合ThreadLocal來適應在多線程場景的正確使用。
JAVA8之後，推薦使用DateTimeFormat替代SimpleDateFormat。

DataTimeFormatter實現

JAVA8開始提供的新的用於日期與字元串之間轉換的類，它很好的解決了SimpleDateFormat多線程的弊端，也可以更方便的與java.time中心的日期時間相關類的集成調用。

public void testDateFormatter() {
    DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    LocalDateTime localDateTime = LocalDateTime.now();
    // 格式化為字元串
    String format = localDateTime.format(dateTimeFormatter);
    System.out.println("當前時間：" + format);
    // 字元串轉Date
    LocalDateTime parse = LocalDateTime.parse("2022-07-08 06:19:27", dateTimeFormatter);
    Date date = Date.from(parse.atZone(ZoneId.systemDefault()).toInstant());
    System.out.println("轉換後Date對象： " + date);
}

輸出結果：

當前時間：2022-07-08 18:37:46
轉換後Date對象： Fri Jul 08 06:19:27 CST 2022

日期時間格式模板

對於電腦而言，時間處理的時候按照基於時間原點的數字進行處理即可，但是轉為人類方便識別的場景顯示時，經常會需要轉換為不同的日期時間顯示格式，比如：

2022-07-08 12:02:34
2022/07/08 12:02:34.238
2022年07月08日 12點03分48秒

在JAVA中，為了方便各種格式轉換，提供了基於時間模板進行轉換的實現能力：

時間格式模板中的字幕含義說明如下：

消失的8小時問題

日期字元串存入DB後差8小時

在後端與資料庫交互的時候，可能會遇到一個問題，就是往DB中存儲了一個時間欄位之後，後面再查詢的時候，就會發現時間數值差了8個小時，這個需要在DB的連接信息中指定下時區信息：

spring.datasource.druid.url=jdbc:mysql://127.0.0.1:3306/test?serverTimezone=Asia/Shanghai

界面時間與後臺時間差8小時

在有一些前後端交互的項目中，可能會遇到一個問題，就是前端選擇並保存了一個時間信息，再查詢的時候就會發現與設置的時間差了8個小時，這個其實就是後端時區轉換設置的問題。

SpringBoot的配置文件中，需要指定時間字元串轉換的時區信息：

spring.jackson.time-zone=GMT+8

這樣從介面json中傳遞過來的時間信息，jackson框架可以根據對應時區轉換為正確的Date數據進行處理。

我是悟道，聊技術、又不僅僅聊技術~

如果覺得有用，請點個關註，也可以關註下我的公眾號【架構悟道】，獲取更及時的更新。

期待與你一起探討，一起成長為更好的自己。

本文來自博客園，作者：架構悟道，歡迎關註公眾號[架構悟道]持續獲取更多乾貨，轉載請註明原文鏈接：https://www.cnblogs.com/softwarearch/p/16459526.html