ms

Tiny milisecond conversion utility

1.0.0

source

npm

Version published: 7 years ago

Maintainers: 2

Weekly downloads: 218,219,784; decreased by-1.64%

Install size: 6.92 kB

Weekly downloads

Package description

What is ms?

The 'ms' npm package is a simple utility library for parsing and formatting various time formats. It allows you to easily convert between different time units such as milliseconds, seconds, minutes, hours, and days. It is commonly used to work with durations and timeouts in a human-readable format.

What are ms's main functionalities?

Convert from milliseconds to human-readable format

This feature allows you to convert a duration in milliseconds to a string that represents the duration in a more human-readable format, such as '1m' for one minute.

"const ms = require('ms');
console.log(ms(60000)); // '1m'"

Convert from human-readable format to milliseconds

This feature enables you to convert a human-readable time format into its equivalent number of milliseconds. For example, '2 days' would be converted to 172800000 milliseconds.

"const ms = require('ms');
console.log(ms('2 days')); // 172800000"

Round trip conversion

This demonstrates a round trip conversion where a human-readable duration is first converted to milliseconds and then back to a human-readable format.

"const ms = require('ms');
const duration = ms('1 hour');
console.log(ms(duration)); // '1h'"

Other packages similar to ms

Readme

Source

ms

Use this package to easily convert various time formats to milliseconds.

Examples

ms('2 days')  // 172800000
ms('1d')      // 86400000
ms('10h')     // 36000000
ms('2.5 hrs') // 9000000
ms('2h')      // 7200000
ms('1m')      // 60000
ms('5s')      // 5000
ms('1y')      // 31557600000
ms('100')     // 100

Convert from milliseconds

ms(60000)             // "1m"
ms(2 * 60000)         // "2m"
ms(ms('10 hours'))    // "10h"

Time format written-out

ms(60000, { long: true })             // "1 minute"
ms(2 * 60000, { long: true })         // "2 minutes"
ms(ms('10 hours'), { long: true })    // "10 hours"

Features

Works both in node and in the browser.
If a number is supplied to ms, a string with a unit is returned.
If a string that contains the number is supplied, it returns it as a number (e.g.: it returns 100 for '100').
If you pass a string with a number and a valid unit, the number of equivalent ms is returned.

Caught a bug?

Fork this repository to your own GitHub account and then clone it to your local device
Link the package to the global module directory: npm link
Within the module you want to test your local development instance of ms, just link it to the dependencies: npm link ms. Instead of the default one from npm, node will now use your clone of ms!

As always, you can run the tests using: npm test

FAQs

What is ms?

Is ms popular?

Is ms well maintained?

Last updated on 19 Mar 2017

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install