pretty-ms

What is pretty-ms?

The pretty-ms npm package is a utility that converts milliseconds into a human-readable format. It is useful for displaying time durations in a more understandable way, such as in logging, performance monitoring, or user interfaces where time intervals need to be presented.

What are pretty-ms's main functionalities?

Convert milliseconds to human-readable string

This feature allows you to convert a numeric value representing milliseconds into a string that describes the duration in days, hours, minutes, and seconds.

const prettyMs = require('pretty-ms');
console.log(prettyMs(1337000000)); // '15d 11h 23m 20s'

Compact output for duration

With the 'compact' option, you can get a shorter string that only includes the largest time unit.

const prettyMs = require('pretty-ms');
console.log(prettyMs(1337000000, {compact: true})); // '15d'

Verbose output for duration

The 'verbose' option allows you to get a more descriptive string with full time unit names.

const prettyMs = require('pretty-ms');
console.log(prettyMs(1337000000, {verbose: true})); // '15 days 11 hours 23 minutes 20 seconds'

Include milliseconds in the output

This feature allows you to include milliseconds in the output with control over the number of decimal places.

const prettyMs = require('pretty-ms');
console.log(prettyMs(1337, {msDecimalDigits: 0})); // '1s 337ms'

Customize the number of decimal places

You can customize the number of decimal places for seconds to tailor the precision of the output.

const prettyMs = require('pretty-ms');
console.log(prettyMs(33333, {secDecimalDigits: 2})); // '33.33s'

Format as colon-separated time

The 'colonNotation' option formats the duration as a colon-separated time, similar to a digital clock display.

const prettyMs = require('pretty-ms');
console.log(prettyMs(9876543210, {colonNotation: true})); // '275:42:34'

Other packages similar to pretty-ms

moment-duration-format

This package extends Moment.js's duration object to format durations. It offers more customization in formatting durations but requires Moment.js as a dependency, which is a larger library compared to pretty-ms.

dayjs

Day.js is a lightweight date library that can also format durations with the duration plugin. It is similar in size to pretty-ms and provides additional date manipulation functionalities.

ms

The ms package is another simple utility to parse various time formats to milliseconds and vice versa. It is less feature-rich than pretty-ms, focusing mainly on conversion between string formats and milliseconds.

humanize-duration

Humanize-duration is a more feature-rich library for converting durations to human-readable strings. It supports multiple languages and has options for rounding, decimal places, and more. It is more comprehensive but also larger in size compared to pretty-ms.

README

pretty-ms

Convert milliseconds to a human readable string: 1337000000 → 15d 11h 23m 20s

Usage

$ npm install --save pretty-ms

var prettyMs = require('pretty-ms');

prettyMs(1337000000);
//=> '15d 11h 23m 20s'

prettyMs(1337);
//=> '1.3s'

prettyMs(133);
//=> '133ms'

// compact option
prettyMs(1337, {compact: true});
//=> '~1s'

// verbose option
prettyMs(1335669000, {verbose: true});
//=> '15 days 11 hours 1 minute 9 seconds'

// can be useful for time durations
prettyMs(new Date(2014, 0, 1, 10, 40) - new Date(2014, 0, 1, 10, 5))
//=> '35m'

API

prettyMs(milliseconds, [options])

milliseconds

Required
Type: number

Milliseconds to humanize.

options

secDecimalDigits

Type: number
Default: 1

Number of digits to appear after the seconds decimal point.

compact

Type: boolean
Default: false

Only show the first unit: 1h 10m → ~1h.

verbose

Type: boolean
Default: false

Use full-length units: 5h 1m 45s → 5 hours 1 minute 45 seconds

CLI

$ npm install --global pretty-ms

$ pretty-ms --help

  Usage
    $ pretty-ms <milliseconds> [--compact] [--verbose] [--sec-decimal-digits <number>]
    echo <milliseconds> | pretty-ms

  Options
    -c, --compact              Only show the first part
    -v, --verbose              Use full-length units
    -d, --sec-decimal-digits   Number of digits to appear after the seconds decimal point

  Examples
    $ pretty-ms 1337
    1.3s
    $ pretty-ms 1337 --verbose
    1.3 seconds
    $ pretty-ms 1337 --compact
    ~1s
    $ pretty-ms 1337 --sec-decimal-digits 4
    1.3370s

License

MIT © Sindre Sorhus