node package manager

ms

ms

Build Status Slack Channel

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?

  1. Fork this repository to your own GitHub account and then clone it to your local device
  2. Link the package to the global module directory: npm link
  3. 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

Unleash awesomeness

Private packages, team management tools, and powerful integrations. Get started with npm Orgs

how? learn more

Collaborators list

Stats

Try it out

Keywords

None

Dependencies

None

Dependents (733)

@unlimit/gateway, wikibattle, prepare-response, @financial-times/n-navigation, web-component-tester-bundle, cacheman_v2, adviser-bot, cat-log, dirmaid, mongoose-reload, jsonwebtoken-refresh, waterline-sails-es, express-sso-auth, express-cache-ctrl, last-word, @mechanicalhuman/logger, samepleMicroservice, realmviewer, layer-webhooks-services-nexmo, fd-proxy-server, locallyjs, desk-server, node_plsql, to-zero, etcd-proxy, koa-redis-session-sets, koala, x-ray-crawler, tldr-cyg, zombie-cors, timedown, firequeue, tier, zombie-nocors, ajl-mongoose, request-easy-cache, transmission-cluster, co-timeout, ko-sleep, fireband, pub-pkg-github-oauth, reap, medcharts, asset_cal, ligle-model-member, basic-timer, github-stream, react-native-debug, utorrent-cluster, dozer-client, and more