NiobeDurations you can read

Write minutes(2) + seconds(30) instead of 150_000. Convert, parse and format durations with small, typed functions.

setTimeout
(refresh
, minutes
(2) + seconds
(30));
// => after 150_000ms

const timeout
 = parseDuration
(config
.timeout
); // '1h 30m'
// => 5_400_000

msToClock
(timeout
);
// => '01:30:00'

clockToMs
('00:02:30') === minutes
(2.5);
// => true

Readable by default
weeks, days, hours, minutes, seconds and smaller units turn amounts into milliseconds, so a duration says what it means.
Convert both ways
Every unit has .from() to turn milliseconds back into that unit, such as minutes.from(150_000) for 2.5.
Parse duration strings
parseDuration reads strings like '1h 30m' or '2m 1s' from config files, environment variables or user input.
Clock strings
clockToMs and msToClock read and write hh:mm:ss, down to nanoseconds.
Split into parts
msToParts breaks a duration into weeks, days, hours and smaller units, and partsToMs puts it back together.
Small and typed
No runtime dependencies, ESM and CommonJS builds, and types for everything, including the constants.

NiobeDurations you can read

Readable by default

Convert both ways

Parse duration strings

Clock strings

Split into parts

Small and typed