mirror of https://github.com/espruino/BangleApps
80 lines
2.8 KiB
JavaScript
80 lines
2.8 KiB
JavaScript
// module "time_utils"
|
|
//
|
|
// Utility functions useful to work with time and durations.
|
|
//
|
|
// This module functions usually receive or return a {d, h, m, s} object
|
|
// or a number of milliseconds representing a time or a duration.
|
|
//
|
|
// The {h, m, s} object encapsulates a "time" (eg: 12:30:00).
|
|
// Note: a "time" needs the day set to 0/undefined, otherwise it is a "duration".
|
|
//
|
|
// The {d, h, m, s} object encapsulates a "duration" in number of days, hours,
|
|
// minutes and seconds (eg. 3d 20h 35m 20s).
|
|
// Note that if a field is undefined then its value is zero.
|
|
//
|
|
|
|
/**
|
|
* @param {object} time {d, h, m, s}
|
|
* @returns the milliseconds contained in the passed time object
|
|
*/
|
|
exports.encodeTime = (time) => {
|
|
time = safeTime(time);
|
|
return time.d * 86400000 + time.h * 3600000 + time.m * 60000 + time.s * 1000;
|
|
}
|
|
|
|
// internal use, set to zero all the undefined fields
|
|
function safeTime(time) {
|
|
return { d: time.d || 0, h: time.h || 0, m: time.m || 0, s: time.s || 0 };
|
|
}
|
|
|
|
/**
|
|
* @param {int} millis the number of milliseconds
|
|
* @returns a time object {d, h, m, s} built from the milliseconds
|
|
*/
|
|
exports.decodeTime = (millis) => {
|
|
if (typeof millis !== "number") throw "Only a number can be decoded";
|
|
var d = Math.floor(millis / 86400000);
|
|
millis -= d * 86400000;
|
|
var h = Math.floor(millis / 3600000);
|
|
millis -= h * 3600000;
|
|
var m = Math.floor(millis / 60000);
|
|
millis -= m * 60000;
|
|
var s = Math.floor(millis / 1000);
|
|
return { d: d, h: h, m: m, s: s };
|
|
}
|
|
|
|
/**
|
|
* @param {object|int} value {h, m} object or milliseconds
|
|
* @returns an human-readable time string like "10:25"
|
|
* @throws an exception if d != 0 or h > 23 or m > 59
|
|
*/
|
|
exports.formatTime = (value) => {
|
|
var time = safeTime(typeof value === "object" ? value : exports.decodeTime(value));
|
|
time.h += time.d*24;
|
|
/*if (time.h < 0 || time.h > 23) throw "Invalid value: must be 0 <= h <= 23";
|
|
if (time.m < 0 || time.m > 59) throw "Invalid value: must be 0 <= m <= 59";*/
|
|
return time.h + ":" + ("0" + time.m).substr(-2);
|
|
}
|
|
|
|
/**
|
|
* @param {object|int} value {d, h, m, s} object or milliseconds
|
|
* @param {boolean} compact `true` to remove all whitespaces between the values
|
|
* @returns an human-readable duration string like "3d 1h 10m 45s" (or "3d1h10m45s" if `compact` is `true`)
|
|
*/
|
|
exports.formatDuration = (value, compact) => {
|
|
compact = compact || false;
|
|
var duration = "";
|
|
var time = safeTime(typeof value === "object" ? value : exports.decodeTime(value));
|
|
if (time.d > 0) duration += time.d + "d ";
|
|
if (time.h > 0) duration += time.h + "h ";
|
|
if (time.m > 0) duration += time.m + "m ";
|
|
if (time.s > 0) duration += time.s + "s"
|
|
duration = duration.trim()
|
|
return compact ? duration.replace(" ", "") : duration;
|
|
}
|
|
|
|
exports.getCurrentTimeMillis = () => {
|
|
var time = new Date();
|
|
return (time.getHours() * 3600 + time.getMinutes() * 60 + time.getSeconds()) * 1000;
|
|
}
|