Duration类

官网地址

基于时间的时间量，例如“34.5秒”。

此类以秒和纳秒为单位对时间的量或量进行建模。它可以使用其他基于持续时间的单位访问，如分钟和小时。此外，可以使用DAYS单位，并将其视为完全等于24小时，从而忽略夏令时的影响。有关此类基于日期的等效项，请参见期间。

物理持续时间可以是无限长的。为了实用，使用类似于Instant的约束来存储持续时间。持续时间使用纳秒分辨率，在长时间内可以保持的最大值为秒。这比目前估计的宇宙年龄还要大。

持续时间的范围需要存储一个大于长的数字。为了实现这一点，该类存储一个表示秒的long和一个表示纳秒秒的int，该值始终在0和999999999之间。该模型具有定向持续时间，这意味着该持续时间可能是负的。

持续时间以“秒”为单位，但这些不一定与基于原子钟的科学“SI秒”定义相同。这种差异只影响在闰秒附近测量的持续时间，不应影响大多数应用程序。请参阅即时讨论第二个和时间刻度的含义。

这是一个基于价值的类；在Duration实例上使用标识敏感操作（包括引用相等（==）、标识哈希代码或同步）可能会产生不可预测的结果，应避免。应使用equals方法进行比较。

实施要求：

这个类是不可变的并且是线程安全的。

按照上图可以查看Duration类。

Duration实现了 TemporalAmount, Comparable<Duration>, Serializable 这几个接口。

方法摘要

方法声明	功能描述
between(Temporal startInclusive，TemporalendExclusive)	获取一个 Duration 实例,表示两个时间对象之间的间隔
toDays()	将时间间隔转换为以天为单位
toHours()	将时间间隔转换为以时为单位
toMinutes()	将时间间隔转换为以分为单位
toSeconds()	将时间间隔转换为以秒为单位
toMillis()	将时间间隔转换为以毫秒为单位
toNanos()	将时间间隔转换为以纳秒为单位
of(long duration)	这个方法用于创建一个表示给定持续时间的Duration对象，单位为纳秒。持续时间可以是从零到Long.MAX_VALUE之间的任何值。
of(long amount, TemporalUnit unit)	用于创建表示特定时间单位的持续时间对象。该方法接受两个参数：amount：表示持续时间的长整型数值。unit：表示时间单位的 TemporalUnit 枚举类型或其子类。
ofDays(long days)	这个方法用于创建一个表示给定天数的Duration对象
ofHours(long hours)	这个方法用于创建一个表示给定小时数的Duration对象。
ofMinutes(long minutes)	这个方法用于创建一个表示给定分钟数的Duration对象。
ofSeconds(long seconds)	这个方法用于创建一个表示给定秒数的Duration对象
ofMillis(long millis)	这个方法用于创建一个表示给定毫秒数的Duration对象
ofNanos(long nanos)	这个方法用于创建一个表示给定纳秒数的Duration对象。
plus(...)	用于将当前Duration对象与另一个Duration对象相加，返回一个新的Duration对象，表示两个时间段的总和。
plusDays(...)	用于将当前Duration对象与指定的天数相加，返回一个新的Duration对象，表示增加天数后的时间段。
plusHours(...)	用于将当前Duration对象与指定的小时数相加，返回一个新的Duration对象，表示增加小时数后的时间段。
plusMinutes(...)	用于将当前Duration对象与指定的分钟数相加，返回一个新的Duration对象，表示增加分钟数后的时间段。
plusSeconds(...)	用于将当前Duration对象与指定的秒数相加，返回一个新的Duration对象，表示增加秒数后的时间段。
plusMillis(...)	用于将当前Duration对象与指定的毫秒数相加，返回一个新的Duration对象，表示增加毫秒数后的时间段。
plusNanos(...)	用于将当前Duration对象与指定的纳秒数相加，返回一个新的Duration对象，表示增加纳秒数后的时间段。
minus(...)	用于从一个Duration对象中减去另一个Duration对象。它返回一个新的Duration对象，表示当前Duration对象与减去的那一个之间的差值。
minusDays(...)	用于从一个Duration对象中减去一定数量的天数。它返回一个新的Duration对象，表示当前Duration对象减去指定天数后的结果。
minusHours(...)	用于从一个Duration对象中减去一定数量的小时数。它返回一个新的Duration对象，表示当前Duration对象减去指定小时数后的结果。
minusMinutes(...)	用于从一个Duration对象中减去一定数量的分钟数。它返回一个新的Duration对象，表示当前Duration对象减去指定分钟数后的结果。
minusSeconds(...)	用于从一个Duration对象中减去一定数量的秒数。它返回一个新的Duration对象，表示当前Duration对象减去指定秒数后的结果。
minusMillis(...)	用于从一个Duration对象中减去一定数量的毫秒数。它返回一个新的Duration对象，表示当前Duration对象减去指定毫秒数后的结果。
minusNanos(...)	用于从一个Duration对象中减去一定数量的纳秒数。它返回一个新的Duration对象，表示当前Duration对象减去指定纳秒数后的结果。

示例代码

import java.time.Duration;
import java.time.LocalDateTime;

public class DurationUtil {


    public static void main(String[] args) {

        LocalDateTime start = LocalDateTime.now();

        LocalDateTime end = LocalDateTime.parse("2024-03-15T00:00:01");

        Duration duration = Duration.between(start, end);

        String timeString = duration.toString();
        System.out.println("相差的天数:  " + duration.toDays());
        System.out.println("相差的小时: " + duration.toHours());
        System.out.println("相差的分钟: " + duration.toMinutes());
        System.out.println("相差的秒数: " + duration.getSeconds());
        System.out.println("相差的毫秒: " + duration.toMillis());
        System.out.println("相差的纳秒: " + duration.toNanos());
        System.out.println("timeString时间: " + timeString);

    }


}

输出结果

相差的天数:  45
相差的小时: 1089
相差的分钟: 65345
相差的秒数: 3920737
相差的毫秒: 3920737222
相差的纳秒: 3920737222000000
timeString时间: PT1089H5M37.222S

---

---

---