Skip to content

unshiftio/millisecond

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

millisecond

Made by unshiftVersion npmBuild StatusDependenciesCoverage StatusIRC channel

Sauce Test Status

Parse strings that indicate a time to their millisecond equivalents.

Installation

This module is written with Node.js and Browserify in mind and can therefor be installed using the node package manager:

npm install --save millisecond

Usage

The module exposes one single function interface, so you simply require it using:

'use strict';

var ms = require('millisecond');

And to parse a string simply supply it as first argument and it will return a number. If we're unable to parse it, we will automatically return 0.

ms('1 second'); // returns 1000
ms('1 ms');     // returns 1
ms('10 cows');  // returns 0

It understands the following strings:

  • x milliseconds
  • x millisecond
  • x msecs
  • x msec
  • x ms
  • x seconds
  • x second
  • x secs
  • x sec
  • x s
  • x minutes
  • x minute
  • x mins
  • x min
  • x m
  • x hours
  • x hour
  • x hrs
  • x hr
  • x h
  • x days
  • x day
  • x d
  • x weeks
  • x week
  • x wks
  • x wk
  • x w
  • x years
  • x year
  • x yrs
  • x yr
  • x y

The space after the number is optional so you can also write 1ms instead of 1 ms. In addition to that it also accepts numbers and strings which only includes numbers and we assume that these are always in milliseconds.

License

MIT

This module is heavily inspired by the ms module which is also licensed under MIT. If you also need to transform numbers back in to strings I suggest you look at that library.