TimeUnit.toMillis() 是 Java 中将任意时间单位转换为毫秒的安全便捷方法，内置精确换算逻辑、自动防溢出、线程安全，且比手动乘法更健壮可读。
TimeUnit.toMillis() 是 Java 中将任意时间单位转换为毫秒的便捷工具，无需手动计算倍数，避免出错。它属于 java.util.concurrent.TimeUnit 枚举类，每个时间单位（如 DAYS、HOURS）都内置了精确的换算逻辑（例如 1 天 = 24×60×60×1000 毫秒），且自动处理整数溢出风险（对极大数值会抛出 ArithmeticException）。
常用时间单位到毫秒的转换示例
直接调用对应枚举常量的 toMillis(long) 方法即可：
-
TimeUnit.DAYS.toMillis(1)→ 86_400_000（1 天） -
TimeUnit.HOURS.toMillis(1)→ 3_600_000（1 小时） -
TimeUnit.MINUTES.toMillis(30)→ 1_800_000（30 分钟） -
TimeUnit.SECONDS.toMillis(45)→ 45_000（45 秒） -
TimeUnit.MILLISECONDS.toMillis(123)→ 123（恒等转换）
统一换算多个不同单位为毫秒（实用场景）
当输入可能是“天数”、“小时数”或“分钟数”时，可先解析原始值和单位标识，再动态调用对应枚举方法：
public static long toMillis(long value, TimeUnit unit) {
return unit.toMillis(value);
}
<p>// 使用示例
long timeoutMs = toMillis(2, TimeUnit.DAYS); // 172_800_000
timeoutMs = toMillis(5, TimeUnit.HOURS); // 18_000_000
timeoutMs = toMillis(90, TimeUnit.MINUTES); // 5_400_000
</p>
这种封装让业务逻辑清晰，单位变更只需改参数，不改计算逻辑。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
注意事项与常见陷阱
使用时需注意以下几点：
- 输入值为 long 类型，传入 int 会自动提升，但大数值（如超过
Long.MAX_VALUE / 86400的天数）可能触发溢出异常 -
TimeUnit.NANOSECONDS.toMillis()会做除法截断（丢弃纳秒部分），例如NANOSECONDS.toMillis(1_999_999)返回0 - 没有直接支持“周”或“月”的枚举，需自行组合（如
TimeUnit.DAYS.toMillis(7)表示一周）；注意“月”不能简单按 30 天处理，应使用java.timeAPI 处理日历语义 - 该方法是静态工具，不依赖实例，线程安全，可放心在高并发场景中使用
替代方案对比：为什么不用手动乘法？
虽然可以写 days * 24L * 60 * 60 * 1000，但容易遗漏 L 导致 int 溢出（如 100 * 24 * 60 * 60 * 1000 在 int 范围内就溢出），而 TimeUnit.DAYS.toMillis(100) 内部已用 long 运算并校验，更健壮。同时代码意图明确，可读性更高。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
