TimeUnit 是用于语义化时间操作、避免毫秒乘除错误的封装类，而非通用换算工具；推荐用 toXXX() 方法进行固定单位转换，convert() 适用于动态单位场景，但需注意参数顺序与溢出风险。
TimeUnit 不是用来“换算”的工具类，而是用来**语义化时间操作、避免手写毫秒乘除错误**的封装。直接用 TimeUnit.SECONDS.toMillis(5) 比 5 * 1000 更安全、更可读，也比自己写 TimeUnit.convert() 更常用。
什么时候该用 TimeUnit.XXX.toYYY() 而不是手动计算
当你需要把一个带单位的数值转成另一个单位（比如把 3 分钟转成毫秒），且目标单位是固定已知的，就用 toXXX() 方法。它内部做了溢出检查和单位对齐，比 * 60 * 1000 少出错。
- 常见误写：
3 * 60 * 1000—— 容易漏乘、顺序错、整型溢出（比如小时转纳秒） - 正确写法：
TimeUnit.MINUTES.toMillis(3)，TimeUnit.HOURS.toNanos(1) - 注意：
toXXX()只支持向上或向下相邻单位转换（如SECONDS.toMillis()可以，但SECONDS.toNanos()是允许的，因为底层支持；而DAYS.toNanos()会触发 long 溢出警告，实际运行可能返回负值）
TimeUnit.convert() 的真实使用场景和陷阱
convert() 是为「动态单位」设计的：源数值和源单位都来自变量，不能在编译期确定。但它不处理溢出，也不做精度补偿，容易被误用。
- 典型用途：解析配置项
timeout: 10, unit: "SECONDS"后统一转成毫秒 - 错误用法：
TimeUnit.SECONDS.convert(5, TimeUnit.MINUTES)—— 这实际是把 5 分钟转成秒数（300），不是你想的“5 秒转分钟” - 记住参数顺序：
convert(value, sourceUnit)，返回的是value在当前 TimeUnit 实例单位下的等效值 - 如果
value是double或需要舍入，convert()会截断小数部分（它只接受long），此时应改用TimeUnit.<em>source</em>.to<em>target</em>(value)配合四舍五入逻辑
和 Duration、Period 的关键区别
TimeUnit 是纯数值单位换算，不表示时间点或时间段语义；Duration（基于纳秒）和 Period（基于日历月/年）才是 Java 8+ 推荐的时间量建模方式。
立即学习“Java免费学习笔记（深入）”；
- 别用
TimeUnit表达“2小时30分”，应该用Duration.ofHours(2).plusMinutes(30) -
TimeUnit无法处理闰秒、夏令时、月份天数不固定等问题；Period可以，但不能直接转毫秒 - 线程等待、超时设置（如
lock.tryLock(3, TimeUnit.SECONDS)）仍是TimeUnit的主战场——API 设计者明确要求你传入单位，而不是裸数字
真正容易被忽略的是：很多开发者把 TimeUnit 当作通用时间计算器，却没意识到它的所有方法都是静态的、无状态的，且不维护任何上下文。一旦涉及跨单位比较（比如 “1.5 小时 > 90 分钟”），靠 TimeUnit 得先统一到同一单位再比，而 Duration 可直接 compareTo()。这不是功能强弱问题，是抽象层级不同。
