深入了解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博客