time.js
方法
(静态) createTimeRanges(start, end) → {TimeRange}
创建一个模仿 HTML5 TimeRanges 实例的 TimeRange
对象。
参数
名称 | 类型 | 描述 |
---|---|---|
start | number | | 单个范围的起始(一个数字)或多个范围的数组(每个包含两个数字的数组)。 |
end | 数字 | 单个范围的结束。不能与 |
返回
- 类型:
- TimeRange
(静态) formatTime(seconds, guide) → {string}
委托给默认的时间格式化函数或通过 setFormatTime
提供的自定义函数。
将秒数格式化为时间字符串 (H:MM:SS 或 M:SS)。提供一个参考值(以秒为单位)将强制添加前导零以覆盖参考值的长度。
参数
名称 | 类型 | 描述 |
---|---|---|
seconds | 数字 | 要转换为字符串的秒数 |
guide | 数字 | 用于生成字符串的参考秒数 |
返回
格式化为 H:MM:SS 或 M:SS 的时间
- 类型:
- string
示例
formatTime(125, 600) === "02:05"
(静态) resetFormatTime()
将 formatTime 重置为默认实现。
(静态) setFormatTime(customImplementation)
用自定义实现替换默认的 formatTime 实现。
参数
名称 | 类型 | 描述 |
---|---|---|
customImplementation | function | 一个将取代默认 formatTime 实现的函数。它将接收当前时间(以秒为单位)和参考值(以秒为单位)作为参数。 |
类型定义
TimeRange
一个包含时间范围的对象,模仿 TimeRanges。
类型
属性- Object
名称 | 类型 | 描述 |
---|---|---|
length | 数字 | 此对象表示的时间范围数量。 |
start | module:time~TimeRangeIndex | 返回指定时间范围开始的时间偏移量。 |
end | module:time~TimeRangeIndex | 返回指定时间范围结束的时间偏移量。 |
TimeRangeIndex(index可选) → {number}
返回 TimeRange 对象中指定索引处的开始或结束时间。
参数
名称 | 类型 | 属性 | 默认 | 描述 |
---|---|---|---|---|
索引 | 数字 | <可选> | 0 | 要返回时间的范围编号。 |
- 已废弃
- 必须提供 index 参数。将来,省略该参数将抛出错误。
返回
指定索引处的时间偏移量。
- 类型:
- 数字