dur

1.0.1 • Public • Published

JavaScript uses milliseconds as a representation of time, which hard to read. dur converts human readable strings to an integer of milliseconds while it's synchronous, very tolerant on input and easy to use.

Install

npm i dur

Usgae

const dur = require("dur");

/* 5 minutes */
console.log(dur("5m")); // = 300000

/* use as much or less units as you like */
console.log(dur("1d3h4m8s")); // = 97448000

/* time units are case insensitive and can be written rather verbose or abbrevated */
console.log(dur("1 Hr and 3 Secs")); // = 3603000

/* you can use floats */
console.log(dur("1 hour 3.4 minutes")); // 3804000

/* but everything will be rounded to milliseconds */
console.log(dur("4.12342323232 seconds")); // 4123

/* if you repeat yourself, it's added up */
console.log(dur("1 d 2d")); // 259200000

/* provide a default value if dealing with user input */
console.log(dur(undefined, 1234)); // 1234

/* else you will get null */
console.log(dur(undefined)); // null

Time Units

  • Year: years, year, yrs, yr, y
  • Week: weeks, week, wks, wk, w
  • Days: days, day, dy, d
  • Hours: hours, hour, hrs, hr, hs, h
  • Minutes: minutes, minute, mins, min, mn, m
  • Seconds: seconds, second, scnds, scnd, secs, sec, s
  • Milliseconds: milliseconds, millisecond, msecs, msec, ms, ``

License

Unlicense.

Package Sidebar

Install

npm i dur

Weekly Downloads

7

Version

1.0.1

License

Unlicense

Unpacked Size

2.73 kB

Total Files

3

Last publish

Collaborators

  • yetzt