TimeUnit.convert() 不支持跨层级单位换算（如天→秒），仅适用于同量级单位间精度保留转换；复杂换算需用 toXxx() 链式调用或 Duration。
TimeUnit.convert() 不能直接换算天→秒或小时→天
TimeUnit.convert() 的设计初衷是「在相同时间单位量级下做带精度保留的转换」，比如把 1000 毫秒转成微秒、或把 3600 秒转成小时——但它**不支持跨层级跳转式换算**（如 DAYS → SECONDS），因为它的第二个参数必须是「源单位」，而第一个参数是「目标单位」，两者之间没有隐式乘除关系。
常见错误现象：TimeUnit.DAYS.convert(1, TimeUnit.SECONDS) 返回 0（不是抛异常），因为 1 秒远小于 1 天，整数截断后为 0；反过来 TimeUnit.SECONDS.convert(1, TimeUnit.DAYS) 返回 86400，看似正确，但这是靠 TimeUnit 内部硬编码的换算系数（1 DAY = 86400 SECONDS）撑起来的，本质仍是「同源换算」，不是通用链式转换。
- 它只适用于「已知一个数值 + 它当前所属单位 → 换成另一个单位」这种一对一映射
- 不适用于「给定 5 天，想转成多少毫秒」这类需多层乘法的场景
- 所有
TimeUnit单位间换算都基于固定系数（如HOURS和SECONDS是 3600），不考虑闰秒、夏令时等现实偏差
复杂换算必须手动组合 TimeUnit.toXxx() 链式调用
要实现「3 天 5 小时 20 分钟 → 总秒数」或「123456 秒 → X 天 Y 小时 Z 分钟」，得靠 TimeUnit 提供的 toDays()、toHours()、toMinutes() 等静态方法组合计算，而不是依赖 convert()。
例如将总秒数拆解为天/小时/分钟：
立即学习“Java免费学习笔记（深入）”；
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
long totalSeconds = 123456; long days = TimeUnit.SECONDS.toDays(totalSeconds); long hours = TimeUnit.SECONDS.toHours(totalSeconds) % 24; long minutes = TimeUnit.SECONDS.toMinutes(totalSeconds) % 60;
注意：toHours() 返回的是「从起点开始的总小时数」，所以要用 % 24 才能得到「当天内的小时」；同理 toMinutes() % 60 才是剩余分钟。
-
toXxx()方法全部返回long，向下取整（即截断小数部分） - 如果原始值是
double（如 1.5 天），先转成基础单位（如秒）再进TimeUnit，否则会丢失精度 - 不要混用
convert()和toXxx()：前者是「单位换算」，后者是「总量提取」，语义不同
跨单位大数换算时小心溢出和精度丢失
当处理「数十年」或「纳秒级高精度时间」时，TimeUnit 的 long 参数很容易溢出。例如：TimeUnit.DAYS.toNanos(100000) 会返回负数——因为 10 万天 ≈ 8.64e15 纳秒，已超过 Long.MAX_VALUE（≈9.2e18）的 1/1000，但某些中间步骤（如先乘 24 再乘 3600 再乘 1e9）可能提前溢出。
- 优先使用更大的基础单位：想算「年→毫秒」？先转成「天」再用
TimeUnit.DAYS.toMillis()，比用TimeUnit.YEARS（JDK 19+ 才有，且不精确）更可控 - 对超大值，改用
Duration或Period：它们内部用BigInteger或分段存储，更适合业务逻辑中的长周期计算 -
TimeUnit所有换算都是无状态的纯函数，不记录时区、历法，也不处理LocalDateTime这类类型——别试图拿它解析字符串时间
替代方案：用 Duration 处理可读性强的复合换算
如果你真正需要的是「3 天 4 小时 30 分钟 = ? 秒」或「把 172800 秒格式化成 `2d 0h 0m`」，Duration 更合适，它天然支持加减、标准化、以及按需提取各字段：
Duration d = Duration.ofDays(3).plusHours(4).plusMinutes(30); long totalSeconds = d.getSeconds(); // 277800 // 或反向解析： Duration parsed = Duration.ofSeconds(172800); long days = parsed.toDays(); long hours = parsed.minusDays(days).toHours(); // 剩余小时 long minutes = parsed.minusDays(days).minusHours(hours).toMinutes();
Duration 虽然底层也用 long 存纳秒，但它封装了标准化逻辑（如自动把 90 分钟转成 1 小时 30 分钟），避免手写 % 和减法出错。
-
Duration.parse("P3DT4H30M")可直接解析 ISO-8601 格式，适合配置驱动场景 - 它和
TimeUnit不互斥：常配合使用，比如用TimeUnit做快速单位缩放，用Duration做结构化表达 - 注意
Duration表示的是「时间跨度」，不是「时刻」，别拿它和Instant混用做时区转换
最常被忽略的一点：Java 的 TimeUnit 本质是一组静态常量+查表系数，它不维护任何上下文，也不感知业务含义。所谓“复杂换算”，其实是你得自己定义什么是“复杂”——是精度要求？是单位组合？还是输出格式？选对工具的前提，是先承认 convert() 本就不为那个场景而生。
