java8 Duration、Period类 - 计算两个“时间”间隔、计算两个“日期”间隔

逃离我推掉我的手 2023-10-05 22:00 4阅读 0赞

#### 文章目录 ####

*   *  前言
     *  一：Duration - 计算两个“时间”间隔的类
     *   *  1.1、Duration常用API：
         *  1.2、计算两个“时间”间隔
     *  二：Period - 计算两个“日期”间隔的类
     *   *  2.1、Period常用API：
         *  2.2、计算两个日期相差的具体天数

### 前言 ###

java8中引入了两个与日期相关的新类

*  Period - 计算两个“日期”间隔的类
 *  Duration - 计算两个“时间”间隔的类

Period 类与 Duration 类都是一段持续时间的概念,如果需要对比时间，它们就需要一个固定的时间值,所以就需要 LocalDate 类与 Instant 、LocalTime、LocalDateTime类来配合它们使用:

*  Period 对应使用 LocalDate ，它们的作用范围域都是日期(年/月/日)
 *  Duration 对应使用 Instant、LocalTime、LocalDateTime，它们的作用范围域都是时间(天/时/分/秒/毫秒/纳秒)

### 一：Duration - 计算两个“时间”间隔的类 ###

Duration 表示一个时间段，Duration 包含两部分：seconds 表示秒，nanos 表示纳秒，它们的组合表达了时间长度。

因为 Duration 表示时间段，所以 Duration 类中不包含 now() 静态方法。注意，Duration 不包含毫秒这个属性。

Duration只能处理两个时间类，例如LocalTime, LocalDateTime, ZonedDateTime; 如果传入的是LocalDate，将会抛出异常

> Duration默认输出格式为PTnHnMnS，如PT8H6M12.345S  
> 以PT前缀开头，H:小时 M:分钟 S:秒  
> 当Duration为0时，默认为：PT0S

#### 1.1、Duration常用API： ####

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static Duration between(Temporal startInclusive, Temporal endExclusive)</td> 
   <td>计算两个时间的间隔，默认是秒</td> 
  </tr> 
  <tr> 
   <td>boolean isNegative()</td> 
   <td>检查Duration实例是否小于0，若小于0返回true, 若大于等于0返回false</td> 
  </tr> 
  <tr> 
   <td>long toDays()</td> 
   <td>将时间转换为以天为单位的long值</td> 
  </tr> 
  <tr> 
   <td>long toHours()</td> 
   <td>将时间转换为以时为单位的long值</td> 
  </tr> 
  <tr> 
   <td>long toMinutes()</td> 
   <td>将时间转换为以分钟为单位的long值</td> 
  </tr> 
  <tr> 
   <td>long toSeconds()</td> 
   <td>将时间转换为以秒为单位的long值</td> 
  </tr> 
  <tr> 
   <td>long toMillis()</td> 
   <td>将时间转换为以毫秒为单位的long值</td> 
  </tr> 
  <tr> 
   <td>long toNanos()</td> 
   <td>将时间转换为以纳秒为单位的long值</td> 
  </tr> 
 </tbody> 
</table>

使用示例：

LocalDateTime start = LocalDateTime.parse("2007-12-03T10:15:30");
    LocalDateTime end = LocalDateTime.parse("2007-12-05T10:25:33");
    
    //between的用法是end-start的时间，若start的时间大于end的时间，则所有的值是负的
    Duration duration = Duration.between(start, end);
    
    String timeString = duration.toString(); //此持续时间的字符串表示形式,使用基于ISO-8601秒*的表示形式,例如 PT8H6M12.345S
    System.out.println("相差的天数="+duration.toDays());
    System.out.println("相差的小时="+ duration.toHours());
    System.out.println("相差的分钟="+duration.toMinutes());
    System.out.println("相差的秒数="+duration.toSeconds());
    System.out.println("相差的毫秒="+duration.toMillis());
    System.out.println("相差的纳秒="+duration.toNanos());
    System.out.println("timeString时间="+timeString);
    
    //isNegative返回Duration实例对象是否为负 
    System.out.println(Duration.between(start, end).isNegative());//false  end-start为正，所以此处返回false
    System.out.println(Duration.between(end, start).isNegative());//true   start-end为负，所以此处返回true
    System.out.println(Duration.between(start, start).isNegative());//false start-start为0，所以此处为false

执行结果：

相差的天数=2
    相差的小时=48
    相差的分钟=2890
    相差的秒数=173403
    相差的毫秒=173403000
    相差的纳秒=173403000000000
    timeString时间=PT48H10M3S

#### 1.2、计算两个“时间”间隔 ####

**方法一：**

> 通过Duration计算两个LocalTime相差的时间

LocalTime start = LocalTime.parse("10:51:01.167526700");
    LocalTime end = LocalTime.parse("15:52:03.167526701");
    
    //between的用法是end-start的时间，若start的时间大于end的时间，则所有的值是负的
    Duration duration = Duration.between(start, end);
    System.out.println("两个时间相差："+duration.toSeconds()+"秒，相差："+duration.toHours()+"小时，相差："+duration.toMinutes()+"分钟");
    
    结果：
    两个时间相差：18062秒，相差：5小时，相差：301分钟

**方法二：**

> ChronoUnit也可以计算两个单元之间的差值。  
> 我们使用ChronoUnit类的between() 方法来执行相同的操作

LocalTime start = LocalTime.parse("10:51:01.167526700");
    LocalTime end = LocalTime.parse("15:52:03.167526701");
    
    long seconds = ChronoUnit.SECONDS.between(start , end );
    long hour = ChronoUnit.HOURS.between(start , end );
    long minute = ChronoUnit.MINUTES.between(start , end );
    
    System.out.println("两个时间相差："+seconds+"秒，相差："+hour+"小时，相差："+minute+"分钟");
    
    结果：
    两个时间相差：18062秒，相差：5小时，相差：301分钟

**方法三：**

> 通过LocalTime类的toSecondOfDay()方法，返回时间对应的秒数，然后计算出两个时间相差的间隔

LocalTime start = LocalTime.parse("10:51:01.167526700");
    LocalTime end = LocalTime.parse("15:52:03.167526701");
    
    int time = end.toSecondOfDay() - start.toSecondOfDay();
    System.out.println("两个时间相差："+time+"秒");
    
    结果：
    两个时间相差：18062秒

**计算两个时间戳的间隔**  
项目中经常会有时间戳的值，下面的示例一起看一下如何比较时间戳。

long todayTimeMillis = System.currentTimeMillis();
    long yesterdayTimeMillis = todayTimeMillis - 24 * 60 * 60 * 1000;
    //通过Instant类，可以直接将毫秒值转换为Instant对象
    Instant yesterday = Instant.ofEpochMilli(yesterdayTimeMillis);
    Instant today = Instant.ofEpochMilli(todayTimeMillis);
    
    Duration duration = Duration.between(yesterday, today);
    System.out.println("天数 = "+duration.toDays()); //天数 = 1

### 二：Period - 计算两个“日期”间隔的类 ###

Period 在概念上和 Duration 类似，区别在于 Period 是以年月日来衡量一个时间段。Duration 用于计算两个时间间隔，Period 用于计算两个日期间隔，所以 between() 方法只能接收 LocalDate 类型的参数。

说明：  
Period可以用于计算两个“日期”之间的间隔，但是得到的是年月日，如两个日期相差1年2月3天，但是没办法知道1年2月3天具体是多少天，下面有讲通过调用ChronoUnit.between()方法计算两个单元相差的天数、月数、年数…

> Period默认输出格式为PnYnMnD，如P2021Y12M3D  
> 以P前缀开头，Y:年 M:月份 D:天  
> 当Period为0时，默认为：P0D

#### 2.1、Period常用API： ####

<table> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>static Period between(LocalDate startDateInclusive, LocalDate endDateExclusive)</td> 
   <td>计算两个日期之间的间隔</td> 
  </tr> 
  <tr> 
   <td>boolean isNegative()</td> 
   <td>检查此时间段的三个单位中是否有一个为负数。这将检查年，月或天的单位是否小于零。如果此期间的任何单位为负，则为true</td> 
  </tr> 
  <tr> 
   <td>int getYears()</td> 
   <td>获取年</td> 
  </tr> 
  <tr> 
   <td>int getMonths()</td> 
   <td>获取月</td> 
  </tr> 
  <tr> 
   <td>int getDays()</td> 
   <td>获取日</td> 
  </tr> 
 </tbody> 
</table>

Period p = Period.of(2021, 12, 3);
    System.out.println("年月日："+p);
    p = Period.ofYears(1);
    System.out.println("年："+p);
    p = Period.ofWeeks(2);
    System.out.println("周的天数"+p);
    
    Period period = Period.of(2021,-1,8);
    System.out.println("校验年月日任何一位值是否有负数：{}",period.isNegative());//true

年月日：P2021Y12M3D
    年：P1Y
    周的天数P14D

注意

*  getYears()、getMonths()、getDays()只能输出Period中的年月日。像如下的示例，想知道两个日期相差多少天需要用ChronoUnit.between()方法。

LocalDate start = LocalDate.of(2020,2,28);
    LocalDate end = LocalDate.of(2021,12,3);
    Period period = Period.between(start,end);
    System.out.println("两个时间之间的差值  年："+period.getYears()+"，月："+period.getMonths()+"，日："+period.getDays());

两个时间之间的差值  年：1，月：9，日：5

#### 2.2、计算两个日期相差的具体天数 ####

**方法一：**  
ChronoUnit也可以计算两个单元之间的天数、月数或年数。  
我们使用ChronoUnit类的between() 方法来执行相同的操作：

LocalDate start = LocalDate.of(2020,2,28);
    LocalDate end = LocalDate.of(2021,12,3);
    long seconds = ChronoUnit.DAYS.between(start , end );
    结果：644
    long month= ChronoUnit.MONTHS.between(start , end );
    结果21
    long year= ChronoUnit.YEARS.between(start , end );
    结果 1

**方法二：**

> 调用LocalDate类的toEpochDay方法，返回距离1970年1月1日的long值  
> 此方法只能计算两个LocalDate日期间的天数，不能计算月份、年数

LocalDate start = LocalDate.of(2020,2,28);
    LocalDate end = LocalDate.of(2021,12,3);
    
    System.out.println("两个时间之间的相差的天数: "+(end.toEpochDay()-start.toEpochDay())); //644