阅读建议

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

本篇文章大概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 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博客

相关链接

评论可见,请评论后查看内容,谢谢!!!
 您阅读本篇文章共花了: