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

阅读建议

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

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

++++

注意

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

Duration

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

java 复制代码
@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类都可以用于表示天的时间段,其他的不行,会抛出异常。

java 复制代码
@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对象。
java 复制代码
@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对象;

java 复制代码
@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(...): 此方法返回此持续时间中的纳秒数部分。与秒一样,这不会考虑任何溢出到更高单位的纳秒数。
java 复制代码
@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对象,表示增加纳秒数后的时间段。
java 复制代码
@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对象减去指定纳秒数后的结果。
java 复制代码
@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对象转换为纳秒数。它返回一个整数值,表示时间段中包含的纳秒数。
java 复制代码
@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博客

相关推荐
XiaoLeisj2 小时前
【JavaEE初阶 — 多线程】单例模式 & 指令重排序问题
java·开发语言·java-ee
paopaokaka_luck2 小时前
【360】基于springboot的志愿服务管理系统
java·spring boot·后端·spring·毕业设计
dayouziei2 小时前
java的类加载机制的学习
java·学习
码农小旋风3 小时前
详解K8S--声明式API
后端
Peter_chq3 小时前
【操作系统】基于环形队列的生产消费模型
linux·c语言·开发语言·c++·后端
Yaml44 小时前
Spring Boot 与 Vue 共筑二手书籍交易卓越平台
java·spring boot·后端·mysql·spring·vue·二手书籍
小小小妮子~4 小时前
Spring Boot详解:从入门到精通
java·spring boot·后端
hong1616884 小时前
Spring Boot中实现多数据源连接和切换的方案
java·spring boot·后端
aloha_7894 小时前
从零记录搭建一个干净的mybatis环境
java·笔记·spring·spring cloud·maven·mybatis·springboot
记录成长java5 小时前
ServletContext,Cookie,HttpSession的使用
java·开发语言·servlet