1.1.0 ā¢ Published 2 years ago
friendly-duration v1.1.0
Converts the given millisecond value in to a human readable format.
GitHub
NPM
Install
yarn add friendly-duration
Or
npm install friendly-duration
Usage
import friendlyDuration from "friendly-duration";
// OR in CommonJS:
// const friendlyDuration = require("friendlyDuration").default;
// friendlyDuration(milliseconds, { OPTIONS })
console.log(friendlyDuration(1000));
// 1 second
console.log(friendlyDuration(86400000 + 10000));
// 1 day and 10 seconds
console.log(friendlyDuration(86400000 + 3600000 + 10000));
// 1 day, 1 hour, and 10 seconds
console.log(friendlyDuration(86400000 + 3600000 + 10000, { addCommas: false }));
// 1 day 1 hour and 10 seconds
Parameters
Parameter | Required | Default | Type | Description |
---|---|---|---|---|
ms | True | N/a | Number | Milliseconds to convert |
options | False | {} | Object | An optional object of the following options |
options.addCommas | False | True | Boolean | Add commas in between values? |
options.oxfordComma | False | True | Boolean | Add an oxford comma? (a comma before an "and" in lists greater than two items) |
options.addAnd | False | True | Boolean | Add an "and" before the last value |
options.allowMs | False | True | Boolean | If the entire value is less than 1 second, show milliseconds instead (otherwise "0 seconds") |
options.commaSeporateThousands | False | True | Boolean | If the days value exceeds 999, add a comma to separate the thousands unit (1,000 instead of 1000) |
options.pluralize | False | True | Boolean | Add an "s" to the end of the value string if the value is greater than 1 (5 seconds instead of 5 second) |
options.strings | False | {} | Object | An optional object of the following strings in with "%" represents the value passed in to the string |
options.strings.day | False | "% day" | string | A string to define the output format of the days value. % will be replaced with the number of days |
options.strings.hour | False | "% hour" | string | A string to define the output format of the hours value. % will be replaced with the number of hours |
options.strings.minute | False | "% minute" | string | A string to define the output format of the minutes value. % will be replaced with the number of minutes |
options.strings.second | False | "% second" | string | A string to define the output format of the seconds value. % will be replaced with the number of seconds |
options.strings.millisecond | False | "% millisecond" | string | A string to define the output format of the milliseconds value. % will be replaced with the number of milliseconds |
Author
š¤ LKD70
- Twitter: @lkdornan70
- Github: @LKD70
Show your support
Give a āļø if this project helped you!