## 📋 目录

- 一、工具类功能
- 二、所需环境
- 三、方法与调用示例（按需调用）
- 四、工具类源码（可直接复制）

## 一、工具类功能

算两个时间点相差多少个指定单位，`java.time` 的时间类型都能传，天及以上按日历语义、秒及以下按时长换算，结束早于开始就是负数，拿回来是一个 `long`。

## 二、所需环境

JDK 17或以上

## 三、方法与调用示例（按需调用）

🔢 **方法序号**：1

🎯 **方法用途**：
- 给两个时间点算相差多少个 `ChronoUnit` 单位，结果按「结束减开始」计
- 月、季、年这类要看历法的差值用天及以上的单位，运行时长用秒及以下的单位

🧩 **方法定义**：`public static <T extends Temporal> long between(T start, T end, ChronoUnit unit)`

🗣️ **入参解释**：`public static <T extends Temporal> between(开始时间, 结束时间, ChronoUnit单位)`

📤 **返回值解释**：`long`，两个时间之间相差的单位数

💡 **边界口径**：
- 结束早于开始得到负数，正向负向都按同一口径截断
- 天及以上走 `ChronoUnit.between` 的日历语义，秒及以下先把间隔当成 `Duration` 再换算，两边对不上是应该的
- 天及以上不绕 `Duration`，长跨度换算纳秒时会溢出
- `LocalDate` 只精确到天，配半天、小时这类小单位按整天算
- 纳秒单位下约 292 年以上的跨度超出 `long` 表示范围，抛 `ArithmeticException`
- 单位与时间类型对不上（`ChronoUnit.FOREVER`、把 `LocalDateTime` 与 `Instant` 混传）抛 `DateTimeException`，不会静默给一个错误差值
- `start`、`end`、`unit` 任一为 null 抛 `NullPointerException`

🧪 **方法示例**：
- 时长侧 `between(start, end, ChronoUnit.MILLISECONDS)` 拿到 `183845123`
- 同一段用 `between(start, end, ChronoUnit.HOURS)` 拿到 `51`
- 日历侧 `between(start, end, ChronoUnit.DAYS)` 拿到 `2`，不足一天的小时被舍掉
- `between(start, end, ChronoUnit.WEEKS)` 拿到 `0`，不到一周就是 0
- 合约期 `between(LocalDate.of(2026, 9, 25), LocalDate.of(2027, 3, 1), ChronoUnit.MONTHS)` 拿到 `5`
- 同一段合约期按天算 `between(LocalDate.of(2026, 9, 25), LocalDate.of(2027, 3, 1), ChronoUnit.DAYS)` 拿到 `157`，月与年不是天数折算
- `LocalDate` 配 `ChronoUnit.HALF_DAYS` 拿到 `314`，先按整天再折半天
- 结束早于开始 `between(end, start, ChronoUnit.SECONDS)` 拿到 `-183846`
- 三百年跨度按 `ChronoUnit.NANOS` 抛 `ArithmeticException`，同样跨度按 `MILLIS` 拿到 `9467107200000`
- `between(start, end, ChronoUnit.FOREVER)` 抛 `UnsupportedTemporalTypeException`
- `between(null, end, ChronoUnit.DAYS)` 抛 `start 不能为 null`

---

🔢 **方法序号**：2

🎯 **方法用途**：
- 同一段时间差用 `TimeUnit` 表达，和线程池、超时参数这类按 `TimeUnit` 计时的旧代码对齐
- 换算口径与 `ChronoUnit` 入口一致，两个入口可以混用

🧩 **方法定义**：`public static <T extends Temporal> long between(T start, T end, TimeUnit unit)`

🗣️ **入参解释**：`public static <T extends Temporal> between(开始时间, 结束时间, TimeUnit单位)`

📤 **返回值解释**：`long`，以该 `TimeUnit` 计的差值

💡 **边界口径**：
- 纳秒用 `Duration.toNanos()`，超过 292 年的跨度会抛 `ArithmeticException`，这是单位本身决定的上限
- 微秒由秒与纳秒两个分量组合算出，不走 `toNanos() / 1000`，因此跨千年的日期差也能正常返回
- 毫秒及以上用 `TimeUnit.convert` 从秒换算，不重复累加误差
- `LocalDate` 入参按整天计，与 `ChronoUnit` 入口一致
- 三个参数任一为 null 抛 `NullPointerException`

🧪 **方法示例**：
- `between(start, end, TimeUnit.NANOSECONDS)` 拿到 `183845123456789`
- 同一段 `between(start, end, TimeUnit.SECONDS)` 拿到 `183845`
- `between(start, end, TimeUnit.HOURS)` 拿到 `51`，与 `ChronoUnit` 入口相等的判断是 `true`
- 公元 1 年到 9999 年按 `TimeUnit.DAYS` 拿到 `3652058`
- 同样这段跨度按 `TimeUnit.MICROSECONDS` 拿到 `315537811200000000`，绕开纳秒累加就不溢出
- 再往上超出 `long` 能表示的微秒范围抛 `ArithmeticException`
- 结束早于开始 `between(end, start, TimeUnit.SECONDS)` 拿到 `-183601`
- `between(start, end, (TimeUnit) null)` 抛 `unit 不能为 null`

## 四、工具类源码（可直接复制）

📦 评论区留言



算两个时间点相差多少个指定单位，java.time 的时间类型都能传，天及以上按日历语义、秒及以下按时长换算，结束早于开始就是负数，拿回来是一个 long。

两个时间差多久？这个Java时间差值工具类2个方法搞定

人工智能

编程语言

Java时间差计算工具类，支持ChronoUnit与TimeUnit双入口，覆盖天/月/年日历语义与秒/毫秒时长换算，兼容LocalDate等Temporal类型，处理溢出与空值异常，附源码与调用示例，适配JDK17+项目快速复用。

Java

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

两个时间差多久？这个Java时间差值工具类2个方法搞定-腾讯云开发者社区-腾讯云

两个时间差多久？这个Java时间差值工具类2个方法搞定

两个时间差多久？这个Java时间差值工具类2个方法搞定

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐