时间转换工具

本模块提供了时间转换相关的工具函数，支持根据时间长短自动选择合适的显示格式。

基础用法

loading

API 说明

formatDuration

function formatDuration(ms: number): string

参数说明

• ms: 毫秒数，number 类型

返回值

返回格式化后的时间字符串，格式根据时间长短自动调整：

• 小于1小时：返回 "MM:SS" 格式
• 小于24小时：返回 "HH:MM:SS" 格式
• 大于等于24小时：返回 "x天x小时x分钟" 格式

使用示例

// 小于1小时 - 显示 MM:SS
formatDuration(1800000) // 输出: "30:00"

// 小于24小时 - 显示 HH:MM:SS
formatDuration(7200000) // 输出: "02:00:00"

// 大于24小时 - 显示中文格式
formatDuration(93600000) // 输出: "1天2小时"

格式说明

1. MM:SS 格式（小于1小时）

   • 分钟和秒都使用两位数表示
   • 例如："05:30"、"30:00"

2. HH:MM:SS 格式（1-24小时）

   • 小时、分钟和秒都使用两位数表示
   • 例如："01:30:00"、"23:59:59"

3. 中文格式（大于24小时）

   • 只显示非零的时间单位
   • 单位包括：天、小时、分钟
   • 例如："1天2小时"、"2天30分钟"

注意事项

1. 输入参数必须是毫秒数
2. 所有数字格式（MM:SS 和 HH:MM:SS）都会自动补零
3. 中文格式会自动省略为零的时间单位
4. 不支持负数时间