A JavaScript library to convert seconds to strings and back using a human readable format.
An updated version of https://github.com/nicolas-van/simple-duration
Examples:
const sd = require('simple-duration-converter');
const i = sd.parse('3h 10m 52s') // i = 11452
console.log(sd.stringify(i + 10)) // prints 3h 11m 2s
npm install simple-duration-converter
Parses a string using the Simple Duration Format and returns the number of seconds corresponding to it.
Formats a number of seconds. The rounding is using the milliseconds as default value but you can pass any other unit as defined bellow.
Here are the possible units:
- y - A Julian year, which means 365.25 days.
- w - 7 days.
- d - 24 hours.
- h - 60 minutes.
- m - 60 seconds.
- s - A second according to the SI.
- ms - 10e-3 seconds.
- µs - 10e-6 seconds.
- ns - 10e-9 seconds.
You can specify any number of units in any order. As example 24s 3h
is perfectly valid. You can also specify
negative amounts of time like -3m
.
When formatting the stringify
function will always use a normalizing process.