A library for parsing and generating a convenient string representation of a time period.
Install with: npm i periodo
In your code:
const periodo = require('periodo');
// Get milliseconds from string representation.
var p = periodo('2y8m');
console.log(p.time);
Suported time units are:
- y Years
- m Months
- w Weeks
- d Days
- h Hours
- mn Minutes
- s Seconds
- ms Milliseconds
const periodo = require('periodo');
// Get string representation from milliseconds
var p1 = periodo(7777777);
console.log(p1.time);
// Works with negatives
var p2 = periodo(-7777777);
console.log(p2.time);
// Define precision time unit
var p3 = periodo(-7777777, 'h');
console.log(p3.time);
// Get difference between two dates
var p4 = periodo.diffDates('2012-12-12', new Date());
console.log(p4.time);
// Increase a date by a given period
var d1 = periodo.addTo('2d', '2012-12-12');
console.log(d1);
// Decrease a date by a given period
var d2 = periodo.addTo('-2d', new Date());
console.log(d2);
If you have found any problems with this module, please:
- Open an issue.
- Describe what happened and how.
- Also in the issue text, reference the label
~bug
.
We will make sure to take a look when time allows us.
If you wish to get that awesome feature or have some advice for us, please:
- Open an issue.
- Describe your ideas.
- Also in the issue text, reference the label
~proposal
.
If you have spotted any enhancements to be made and is willing to get your hands dirty about it, fork us and submit your merge request so we can collaborate effectively.