Check out JSR for documentation.
Duration follows the performance.now() format, so microseconds and nanoseconds
go after the decimal point.
$ npm install --save @retraigo/duration.js # NPM
$ pnpm install @retraigo/duration.js # PNPMIf you are using NodeJS with TypeScript, use a duration.js version >=4.2.0.
// Node
import Duration from "@retraigo/duration.js";
// Deno
import Duration from "jsr:@retraigo/duration.js@5.0.0";
import Duration from "npm:@retraigo/duration.js@5.0.0";
const Duration = await import("@retraigo/duration.js"); // Node with CommonJS
new Duration(); // Just 0
new Duration(3545346); // A random duration
new Duration(0); // Just 0
new Duration(-1); // Negative duration returns a negative durationPrior to v5, new Duration(n) for n < 0 returned a 0 duration. This has
been changed since there is no reason not to support negative durations. If you
want to keep the v4 behavior, use new Duration(Math.max(n, 0)).
const start = performance.now();
// Do some long task
const d = Duration.since(start);const start = performance.now();
// Do some long task
const check = performance.now();
const d = Duration.between(start, check);Duration.fromString("1m2s"); // Duration {d:0, h:0, m:1, s:2, ms:0}
Duration.fromString("4090 sec 4939 days 7342 hour 2324milliseconds 4344 min"); // // Duration {d: 5246, h: 13, m: 52, s: 12, ms: 324 }You can also get the entire Duration in milliseconds through the raw property.
const dur = Duration.fromString(
"4090 sec 4939 days 7342 hour 2324milliseconds 4344 min",
);
dur.raw; // 453304332324Duration {
raw: 0 // Original milliseconds passed to the constructor
d: 0, // Days
h: 0, // Hours
m: 0, // Minutes
s: 0, // Seconds
ms: 0 // Milliseconds
us: 0 // Microseconds
ns: 0 // Nanoseconds
};const duration = new Duration(59834344.334);
console.log(duration);
// Duration { raw: 59834344.334, d: 0, h: 16, m: 37, s: 14, ms: 344, us: 334, ns: 0 }
console.log(duration.toShortString());
// 0d 16h 37m 14s 344ms 334us 0ns
console.log(duration.toShortString(true)); // Show only non-zero values
// 16h 37m 14s 344ms 334us
console.log(duration.toShortString(["h", "m", "s"])); // Show only specified values
// 16h 37m 14s
console.log(duration.toDescriptiveString());
// 0 days, 16 hours, 37 minutes, 14 seconds, 344 milliseconds, 334 microseconds, 0 nanoseconds
console.log(duration.toWordString());
// zero days, sixteen hours, thirty seven minutes, fourteen seconds,
// three hundred and forty four milliseconds, three hundred and thirty
// four microseconds, zero nanoseconds
console.log(duration.toTimeString());
// 00:16:37:14:344:334:000Join our Discord server here