time.md 1.2 KB
time
Utilities for time manipulation.
convert(value, sourceUnit, [destinationUnit]):Number
Converts time between units.
Available units: millisecond, second, minute, hour, day, week.
Abbreviations: ms, s, m, h, d, w.
We do not support year and month as a time unit since their values are not fixed.
The default destinationUnit is ms.
convert(1, 'minute'); // 60000
convert(2.5, 's', 'ms'); // 2500
convert(2, 'm', 's'); // 120
convert(500, 'ms', 's'); // 0.5
now():Number
Returns the number of milliseconds elapsed since 1 January 1970 00:00:00 UTC.
Uses Date.now() if available.
Example
now(); // 1335449614650
parseMs(ms):Object
Parse timestamp (milliseconds) into an object {milliseconds:number,
seconds:number, minutes:number, hours:number, days:number}.
Example
// {days:27, hours:4, minutes:26, seconds:5, milliseconds:454}
parseMs(2348765454);
toTimeString(ms):String
Convert timestamp (milliseconds) into a time string in the format "[H:]MM:SS".
Example
toTimeString(12513); // "00:12"
toTimeString(951233); // "15:51"
toTimeString(8765235); // "2:26:05"