TimeUnit 是 Java 并发包中通过枚举+方法调用替代魔法数字的时间单位工具类，提升可读性、避免计算错误、统一并发 API 风格，并区分 toXxx() 与 convert() 的语义。
TimeUnit 是 Java 并发包中一个被低估但极其实用的工具类，它让时间单位换算不再依赖硬编码的魔法数字（比如 1000 表示毫秒转秒），而是通过枚举+方法调用表达清晰意图，大幅提升代码可读性与可维护性。
用枚举值替代数字常量，明确时间语义
直接写 Thread.sleep(5000) 无法一眼看出是“5秒”还是“5毫秒”。而使用 TimeUnit.SECONDS.sleep(5)，语义一目了然——让线程休眠 5 秒。同理：
-
TimeUnit.MINUTES.toMillis(2)→ 2 分钟转为毫秒（120000） -
TimeUnit.HOURS.convert(7200, TimeUnit.SECONDS)→ 将 7200 秒转为小时（2） -
TimeUnit.DAYS.toSeconds(1)→ 1 天等于多少秒（86400）
避免手动计算，减少溢出与精度错误
不同单位间换算涉及大数乘除（如纳秒转天），手动计算易出错且可能溢出。TimeUnit 内部已做优化处理：
- 它使用
Math.multiplyExact和Math.divideExact等安全运算，抛出ArithmeticException而非静默截断 - 支持从纳秒到天的全量单位（
NANOSECONDS,MICROSECONDS,MILLISECONDS,SECONDS,MINUTES,HOURS,DAYS） - 例如：
TimeUnit.DAYS.toNanos(1)返回精确的86400_000_000_000L，而非靠24*60*60*1_000_000_000手算（可能因 int 溢出变成负数）
配合并发原语，提升 API 使用一致性
许多并发工具类（如 ThreadPoolExecutor、Lock.tryLock()、CompletableFuture.orTimeout()）都接受 time + TimeUnit 参数。统一使用 TimeUnit 可保持风格一致：
-
lock.tryLock(3, TimeUnit.SECONDS)比lock.tryLock(3000, TimeUnit.MILLISECONDS)更贴近业务含义 -
executor.schedule(task, 10, TimeUnit.MINUTES)明确表达“10 分钟后执行”，无需换算成毫秒再传 - 自定义超时逻辑时，推荐封装为
public void doWithTimeout(Runnable task, long timeout, TimeUnit unit)，而非固定用毫秒
注意 convert() 与 toXxx() 的语义差异
两者都做单位转换，但用途略有不同：
-
toXxx(long duration)：把当前单位的数值，转换为指定单位的等效值（总是向上/向下取整，返回 long）。例如SECONDS.toMillis(1)返回1000 -
convert(long sourceDuration, TimeUnit sourceUnit)：把 sourceUnit 单位的 sourceDuration，转换为当前 TimeUnit 的等效值。例如MILLISECONDS.convert(5000, SECONDS)返回5 - 推荐优先用
toXxx()（更直观），仅在参数本身是其他单位时才用convert()
不复杂但容易忽略：TimeUnit 不是“高级功能”，而是让时间逻辑回归人话的基础习惯。一次重构，长期受益。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
