计算两个日期的分钟差值方法
时间:2026-03-05 14:21:49 343浏览 收藏
本文深入剖析了Java中因误用Duration.between()计算LocalDate间分钟差值而触发UnsupportedTemporalTypeException的根源,明确指出LocalDate不支持SECONDS等时间单位的本质限制,并系统性地提供了两种语义清晰、类型安全的解决方案:若仅需日期跨度(忽略时间),应使用ChronoUnit.DAYS配合固定换算;若需精确到分钟的真实时长,则必须改用LocalDateTime或Instant等支持秒级精度的类型配合Duration。通过严谨的类型选择、正确的解析方式和关键注意事项提醒,帮助开发者彻底规避运行时崩溃,写出健壮、可读、可维护的时间计算代码。

本文详解 UnsupportedTemporalTypeException: Unsupported unit: Seconds 异常的根本原因,并提供基于 LocalDate 的安全、准确的分钟差值计算方法,避免误用 Duration.between() 导致运行时崩溃。
本文详解 `UnsupportedTemporalTypeException: Unsupported unit: Seconds` 异常的根本原因,并提供基于 `LocalDate` 的安全、准确的分钟差值计算方法,避免误用 `Duration.between()` 导致运行时崩溃。
在 Java 8+ 的 java.time API 中,Duration.between(Temporal, Temporal) 方法要求传入的两个时间对象必须支持 SECONDS 时间单位(如 LocalDateTime、Instant 或 ZonedDateTime),因为 Duration 本质上表示精确到纳秒的固定时间长度(例如“3600秒”或“120_000_000_000 纳秒”)。
而 LocalDate 仅表示不带时分秒的纯日期(如 2023-10-01),其内部不包含时间信息,也不支持 SECONDS、MINUTES 等时间单位——正如官方文档明确指出:LocalDate.isSupported(ChronoUnit.SECONDS) 返回 false。因此,以下代码会直接抛出异常:
LocalDate firstDate = LocalDate.parse("2023-01-01 10:00:00",
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")); // ⚠️ 解析失败!LocalDate 不接受时间部分
LocalDate secondDate = LocalDate.parse("2023-01-03 15:30:00",
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
Duration.between(firstDate, secondDate); // ❌ 抛出 UnsupportedTemporalTypeException⚠️ 关键问题叠加:
- LocalDate.parse(...) 无法解析含 HH:mm:ss 的字符串(会抛 DateTimeParseException),实际运行中该行已先失败;
- 即便绕过解析问题(如改用 LocalDateTime),若错误地传入 LocalDate,Duration.between() 仍因单位不支持而崩溃。
✅ 正确解法:按语义选择合适的类型与工具
| 场景 | 推荐类型 | 计算方式 | 说明 |
|---|---|---|---|
| 仅比较日期(忽略时间)→ 求“天数差 × 1440 分钟” | LocalDate | ChronoUnit.DAYS.between(start, end) * 60 * 24 | 假设每日恒为 24 小时,适用于业务逻辑仅关注日期跨度(如“请假 X 天”) |
| 需精确到分钟(含时间)→ 求真实经过分钟数 | LocalDateTime | Duration.between(start, end).toMinutes() | 支持 SECONDS,可精准计算(如 2023-01-01T10:00 → 2023-01-01T12:30 = 150 分钟) |
示例:修复原函数(支持日期+时间)
public long datetimeDiffInMinutes(String dateStop, String dateStart) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
LocalDateTime start = LocalDateTime.parse(dateStart, formatter);
LocalDateTime stop = LocalDateTime.parse(dateStop, formatter);
return Duration.between(start, stop).toMinutes(); // ✅ 正常工作
}示例:若坚持使用 LocalDate(仅日期)
public long dateDiffInMinutes(String dateStop, String dateStart) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
LocalDate start = LocalDate.parse(dateStart, formatter);
LocalDate stop = LocalDate.parse(dateStop, formatter);
long days = ChronoUnit.DAYS.between(start, stop);
return days * 24 * 60; // 假设每天 24 小时,返回总分钟数
}? 注意事项总结:
- Duration 表达的是绝对时间长度,必须基于支持 SECONDS 的类型(LocalDateTime/Instant/ZonedDateTime);
- LocalDate 仅用于日历日期运算,应使用 ChronoUnit(如 DAYS, MONTHS)而非 Duration;
- 若涉及跨时区或夏令时场景,务必使用 ZonedDateTime 并显式指定时区,避免因 Duration 忽略时区导致逻辑偏差;
- 永远优先使用 DateTimeFormatter.ofPattern(...) 而非 DateTimeFormatter.ISO_LOCAL_DATE_TIME,确保格式严格匹配输入字符串。
通过语义对齐类型与操作,即可彻底规避 UnsupportedTemporalTypeException,写出健壮、可维护的时间计算逻辑。
本篇关于《计算两个日期的分钟差值方法》的介绍就到此结束啦,但是学无止境,想要了解学习更多关于文章的相关知识,请关注golang学习网公众号!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
454 收藏
-
266 收藏
-
455 收藏
-
451 收藏
-
407 收藏
-
204 收藏
-
284 收藏
-
369 收藏
-
190 收藏
-
202 收藏
-
254 收藏
-
418 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习