怎么通过 Duration.between() 计算两个本地时间点之间的分钟数差

夜强酱_4551

夜强酱_4551

2026-05-02

838人浏览

原创

Duration.between()返回Duration对象,需调用toMinutes()获取截断整数分钟,或用toNanos()除以60_000_000_000.0得精确小数分钟;推荐优先用Instant避免时区问题,大跨度场景可用ChronoUnit.MINUTES.between()防溢出。

怎么通过 duration.between() 计算两个本地时间点之间的分钟数差

Duration.between() 返回的是 Duration,不是直接的分钟数

Duration.between() 接收两个 Temporal(如 LocalDateTime、Instant),返回一个 Duration 对象,它内部以纳秒为单位存储时长。你不能直接把它当整数用,必须显式提取分钟数。

常见错误是写成:Duration.between(t1, t2).toMinutes() 看似合理,但要注意:如果两个时间点跨天或含秒/毫秒,toMinutes() 会向下取整(丢弃不足一分钟的部分),而有时你需要四舍五入或精确到小数分钟。

  • 用 toMinutes() 获取**整数分钟(截断)**,适合做粗略判断(比如“是否超过5分钟”)
  • 用 toNanos() 再除以 60_000_000_000L 可得**精确小数分钟**(需转 double)
  • 若输入是 LocalDateTime,确保它们在同一时区上下文里比较——Duration.between() 本身不处理时区,只算时间轴上的差值

LocalDateTime 之间计算要小心“无时区”陷阱

LocalDateTime 没有时区信息,Duration.between() 只做纯数值差。比如 2024-03-10T01:30 到 2024-03-10T02:15 算出来是 45 分钟;但如果这天是夏令时开始日(如美国东部时间跳过 02:00),实际物理时间可能不是 45 分钟——Duration 不关心这个,它只按你给的字面值算。

  • 业务上涉及真实流逝时间(如用户操作耗时、服务响应延迟),优先用 Instant 而非 LocalDateTime
  • 若必须用 LocalDateTime,确认输入已按需转换(例如统一转为系统默认时区的 Instant 后再算)
  • 别把 LocalDateTime 和 ZonedDateTime 混着传给 Duration.between(),会编译报错

正确示例:从 LocalDateTime 得到 double 类型分钟数

LocalDateTime start = LocalDateTime.of(2024, 3, 10, 14, 23, 30, 123_000_000);
LocalDateTime end = LocalDateTime.of(2024, 3, 10, 14, 28, 45, 456_000_000);

Duration d = Duration.between(start, end);
long minutesTruncated = d.toMinutes(); // → 5
double minutesExact = (double) d.toNanos() / 60_000_000_000.0; // → 5.2555

注意 60_000_000_000.0 是 60 秒 × 10⁹ 纳秒/秒,写成带小数点的 double 字面量,避免整数除法截断。

toMinutes() 的溢出风险容易被忽略

Duration.toMinutes() 返回 long,但如果两个 LocalDateTime 相差极大(比如相隔几百年),Duration 内部纳秒值可能超出 long 表达范围,调用 toMinutes() 会抛 ArithmeticException。

  • 生产环境处理用户输入的时间范围时,建议先用 Duration.abs().getSeconds() 粗略检查是否过大(比如 > Long.MAX_VALUE / 60)
  • 更稳妥的做法是用 ChronoUnit.MINUTES.between() 替代:它对 LocalDateTime 直接支持,且不会因纳秒溢出崩溃
  • ChronoUnit.MINUTES.between(t1, t2) 返回的是 long,但它是基于日期时间字段计算的,不依赖纳秒精度,适合大跨度场景
真正麻烦的不是怎么写这一行代码,而是想清楚你要的是“日历分钟”还是“物理分钟”,以及输入时间点有没有隐含的时区或夏令时语义——这些不会在编译时报错,但会在某年三月某个周日悄悄出问题。
PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11477

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8602

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7392

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1476

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3009

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20271

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习