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

Install

Download manually or with a package-manager.

npm

$ npm install --save pretty-ms

Bower

$ bower install --save pretty-ms

Component

$ component install sindresorhus/pretty-ms

Example

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

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

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

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

// 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

options.compact

Type: boolean

Only show the first unit: 995ms ➔ ~1s.

CLI

You can also use it as a CLI app by installing it globally:

$ npm install --global pretty-ms

Usage

$ pretty-ms --help

Usage
  $ pretty-ms <milliseconds> [--compact]
  $ echo <milliseconds> | pretty-ms

Example
  $ pretty-ms 1337
  1.3s

License

MIT © Sindre Sorhus