A JavaScript library to convert seconds to strings and back using a human readable format
MIT License
A JavaScript library to convert seconds to strings and back using a human readable format.
simple-duration is an implementation of the Simple Duration Format 1.0.
Examples:
import * as sd from 'simple-duration'
const i = sd.parse('3h 10m 52s') // i = 11452
console.log(sd.stringify(i + 10)) // prints 3h 11m 2s
npm install simple-duration
parse(str)
Parses a string using the Simple Duration Format and returns the number of seconds corresponding to it.
stringify(seconds, rounding='ms')
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:
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.