humanize-duration-ms

A lightweight utility to convert milliseconds into a human-readable duration string.

Installation

npm install humanize-duration-ms

Usage

const humanizeDuration = require('humanize-duration-ms');

// Basic usage
console.log(humanizeDuration(1000));       // "1 second"
console.log(humanizeDuration(61000));     // "1 minute, 1 second"
console.log(humanizeDuration(3661000));   // "1 hour, 1 minute, 1 second"

// Edge cases
console.log(humanizeDuration(0));         // "0 seconds"
console.log(humanizeDuration(60000));     // "1 minute"

API

humanizeDuration(ms)

• ms (Number): Duration in milliseconds (must be a non-negative number)
• Returns: (String) Human-readable duration string

Examples

const humanizeDuration = require('humanize-duration-ms');

// Different time durations
console.log(humanizeDuration(1000));         // "1 second"
console.log(humanizeDuration(60000));       // "1 minute"
console.log(humanizeDuration(3600000));     // "1 hour"
console.log(humanizeDuration(3661000));     // "1 hour, 1 minute, 1 second"
console.log(humanizeDuration(90000));       // "1 minute, 30 seconds"

Error Handling

Throws an error if the input is not a number or is negative:

try {
  humanizeDuration('not a number');
} catch (e) {
  console.error(e.message); // "Input must be a non-negative number in milliseconds"
}

License

MIT © Awais Manzoor