深入了解Java Duration类，对时间的精细操作

阅读建议

嗨，伙计！刷到这篇文章咱们就是有缘人，在阅读这篇文章前我有一些建议：

本篇文章大概6000多字，预计阅读时间长需要5分钟。
本篇文章的实战性、理论性较强，是一篇质量分数较高的技术干货文章，建议收藏起来，方便时常学习与回顾，温故而知新。
创作不易，免费的点赞、关注，请走上一走，算是对博主一些鼓励，让我更有动力输出更多的干货内容。

注意

本文编写的单元测试是基于java11，具体的版本号是：11.0.19

Duration

Duration 是 Java 中表示时间段的类，用于计算两个时间点之间的间隔。它包含秒（seconds）和纳秒（nanos）两个部分，可以表示毫秒及更小的时间单位。与 Java 中的其他时间类不同，Duration 不包含毫秒这个属性。

@Test
public void test(){
    Duration duration=Duration.of(60, ChronoUnit.SECONDS);
    LocalDateTime localDateTime = LocalDateTime.of(2023, 1, 1, 13, 1, 1);
    LocalDateTime plus = localDateTime.plus(duration);//计算当前日期时间，加上指定时间段后的日期时间
    System.out.println(plus);//输出结果：2023-01-01T13:02:01
}

与Period类相比，Duration类和Period类都用于表示时间段，但它们在表示的时间单位和使用方式上有所不同。Period类主要用于表示年、月、日等较大的时间单位，而Duration类主要用于表示更小的时间单位，例如毫秒、纳秒等。此外，Period类提供了一些方法来获取时间段中的年、月、日等信息，而Duration类则提供了更多的方法来进行时间计算和操作。在实际使用过程中，Duration类和Period类都可以用于表示天的时间段，其他的不行，会抛出异常。

@Test
public void test2(){
    Duration duration=Duration.of(1,ChronoUnit.DAYS);
    Period period = Period.ofDays(1);
    System.out.println(period.getDays() == duration.toDays());
}

核心方法

Duration的核心方法包括：

Duration#of(...)

Duration#of(long duration)：这个方法用于创建一个表示给定持续时间的Duration对象，单位为纳秒。持续时间可以是从零到Long.MAX_VALUE之间的任何值。
Duration.of(long amount, TemporalUnit unit) 用于创建表示特定时间单位的持续时间对象。该方法接受两个参数：amount：表示持续时间的长整型数值。unit：表示时间单位的 TemporalUnit 枚举类型或其子类。

Duration#ofDays(long days)：这个方法用于创建一个表示给定天数的Duration对象。
Duration#ofHours(long hours)：这个方法用于创建一个表示给定小时数的Duration对象。
Duration#ofMinutes(long minutes)：这个方法用于创建一个表示给定分钟数的Duration对象。
Duration#ofSeconds(long seconds)：这个方法用于创建一个表示给定秒数的Duration对象。
Duration#ofMillis(long millis)：这个方法用于创建一个表示给定毫秒数的Duration对象。
Duration#ofNanos(long nanos)：这个方法用于创建一个表示给定纳秒数的Duration对象。

@Test
public void test2() {
    Duration duration = Duration.of(1, ChronoUnit.DAYS);
    duration = Duration.ofDays(1);
    duration = Duration.ofHours(24);
    duration = Duration.ofMinutes(60);
    duration = Duration.ofSeconds(60);
    duration = Duration.ofMillis(1000);
    LocalDateTime localDateTime = LocalDateTime.of(2023, 1, 1, 13, 1, 1);
    LocalDateTime plus = localDateTime.plus(duration);//计算当前日期时间加上指定时间段后的日期时间
    System.out.println(plus);//输出结果：2023-01-01T13:01:02
}

Duration#between(...)

Duration.between(LocalDateTime start, LocalDateTime end)用于计算两个 LocalDateTime 对象之间的持续时间。该方法接受两个参数：start：表示起始时间的 LocalDateTime 对象。end：表示结束时间的 LocalDateTime 对象，返回值是Duration对象；

@Test
public void test3() {
    LocalDateTime localDateTime1 = LocalDateTime.of(2023, 1, 1, 13, 1, 1);
    LocalDateTime localDateTime2 = LocalDateTime.of(2023, 1, 1, 15, 1, 1);
    Duration duration = Duration.between(localDateTime1, localDateTime2);
    long seconds = duration.getSeconds();
    System.out.println(seconds);//输出结果：7200
}

Duration#get(...)

Duration#get(...): 此方法返回在给定单位中的持续时间。它接受一个 java.time.temporal.TemporalUnit 参数，并返回该单位的数量。例如，如果你使用 java.time.temporal.ChronoUnit.SECONDS，此方法将返回持续时间中的秒数。

Duration#getUnits(...): 此方法返回此持续时间包含的单位数。这通常与 get() 方法一起使用，以确定持续时间的长度，但不具体到秒或纳秒。例如，如果你有一个持续时间为2天、3小时、4分钟和5秒，那么 getUnits() 将返回一个包含这些单位的 long[] 数组。
Duration#getSeconds(...): 此方法返回此持续时间中的秒数部分。需要注意的是，这与 get(java.time.temporal.ChronoUnit.SECONDS) 方法略有不同，后者将考虑任何溢出到分钟、小时或天数的秒数。
Duration#getNano(...): 此方法返回此持续时间中的纳秒数部分。与秒一样，这不会考虑任何溢出到更高单位的纳秒数。

@Test
public void test4() {
    Duration duration = Duration.ofHours(2);
    List<TemporalUnit> units = duration.getUnits();
    System.out.println(units.toString());//输出结果：[Seconds, Nanos]
    long seconds = duration.get(ChronoUnit.SECONDS);
    System.out.println(seconds);//输出结果：7200
    long seconds1 = duration.getSeconds();
    System.out.println(seconds1);//输出结果：7200
    duration = Duration.ofNanos(10000);
    int nano = duration.getNano();
    System.out.println(nano);//输出结果：10000
}

Duration#plus(...)

Duration#plus(...)用于将当前Duration对象与另一个Duration对象相加，返回一个新的Duration对象，表示两个时间段的总和。

Duration#plusDays(...)用于将当前Duration对象与指定的天数相加，返回一个新的Duration对象，表示增加天数后的时间段。
Duration#plusHours(...)用于将当前Duration对象与指定的小时数相加，返回一个新的Duration对象，表示增加小时数后的时间段。
Duration#plusMinutes(...)用于将当前Duration对象与指定的分钟数相加，返回一个新的Duration对象，表示增加分钟数后的时间段。
Duration#plusSeconds(...)用于将当前Duration对象与指定的秒数相加，返回一个新的Duration对象，表示增加秒数后的时间段。
Duration#plusMillis(...)用于将当前Duration对象与指定的毫秒数相加，返回一个新的Duration对象，表示增加毫秒数后的时间段。
Duration#plusNanos(...)用于将当前Duration对象与指定的纳秒数相加，返回一个新的Duration对象，表示增加纳秒数后的时间段。

@Test
public void test5() {
    LocalDateTime localDateTime = LocalDateTime.of(2023, 1, 1, 15, 1, 1);
    Duration duration = Duration.ofHours(2);//定义一个2小时的时间段
    duration=duration.plus(60,ChronoUnit.MINUTES);//当前时间段加上60分钟
    duration=duration.plusDays(1);//当前时间段加上1天
    duration=duration.plusHours(1);//当前时间段加上1小时
    duration=duration.plusMinutes(60);//当前时间段加上60分钟
    duration=duration.plusSeconds(60);//当前时间段加上60秒
    LocalDateTime plus = localDateTime.plus(duration);//计算当前日期时间，加上当前的时间段后的日期时间
    System.out.println(plus);//输出结果：2023-01-02T20:02:01
}

Duration#minus(...)

Duration#minus(...): 用于从一个Duration对象中减去另一个Duration对象。它返回一个新的Duration对象，表示当前Duration对象与减去的那一个之间的差值。

Duration#minusDays(...): 用于从一个Duration对象中减去一定数量的天数。它返回一个新的Duration对象，表示当前Duration对象减去指定天数后的结果。
Duration#minusHours(...): 用于从一个Duration对象中减去一定数量的小时数。它返回一个新的Duration对象，表示当前Duration对象减去指定小时数后的结果。
Duration#minusMinutes(...): 用于从一个Duration对象中减去一定数量的分钟数。它返回一个新的Duration对象，表示当前Duration对象减去指定分钟数后的结果。
Duration#minusSeconds(...): 用于从一个Duration对象中减去一定数量的秒数。它返回一个新的Duration对象，表示当前Duration对象减去指定秒数后的结果。
Duration#minusMillis(...): 用于从一个Duration对象中减去一定数量的毫秒数。它返回一个新的Duration对象，表示当前Duration对象减去指定毫秒数后的结果。
Duration#minusNanos(...): 用于从一个Duration对象中减去一定数量的纳秒数。它返回一个新的Duration对象，表示当前Duration对象减去指定纳秒数后的结果。

@Test
public void test6() {
    LocalDateTime localDateTime = LocalDateTime.of(2023, 1, 10, 15, 1, 1);
    Duration duration = Duration.ofHours(2);//定义一个2小时的时间段
    duration = duration.minus(60, ChronoUnit.MINUTES);//当前时间段减去60分钟
    duration = duration.minusDays(1);//当前时间段减去1天
    duration = duration.minusHours(1);//当前时间段减去1小时
    duration = duration.minusMinutes(60);//当前时间段减去60分钟
    duration = duration.minusSeconds(60);//当前时间段减去60秒
    LocalDateTime minus = localDateTime.minus(duration);//计算当前日期时间，减去当前的时间段后的日期时间
    System.out.println(minus);//输出结果：2023-01-11T16:02:01
}

Duration#toDays()

Duration#toDays(): 将Duration对象转换为天数。它返回一个整数值，表示时间段中包含的天数。

Duration#toHours(): 将Duration对象转换为小时数。它返回一个整数值，表示时间段中包含的小时数。
Duration#toMinutes(): 将Duration对象转换为分钟数。它返回一个整数值，表示时间段中包含的分钟数。
Duration#toSeconds(): 将Duration对象转换为秒数。它返回一个整数值，表示时间段中包含的秒数。
Duration#toMillis(): 将Duration对象转换为毫秒数。它返回一个整数值，表示时间段中包含的毫秒数。
Duration#toNanos(): 将Duration对象转换为纳秒数。它返回一个整数值，表示时间段中包含的纳秒数。

@Test
public void test7() {
    Duration duration = Duration.ofDays(1);//定义一个24小时的时间段
    long days = duration.toDays();//结果：1
    long hours = duration.toHours();//结果：24
    long minutes = duration.toMinutes();//结果：1440
    long seconds = duration.toSeconds();//结果：86400
}

上一篇：深入了解Java Period类，对时间段的精确控制-CSDN博客