datetime-difference
A lightweight module which finds the difference between two dates in the human-friendly format. Works almost exactly like moment's duration(...) do, but has no dependencies on any libraries — the code is fast and minimal!
In this fork
This fork has PR #3, #4 and #5 merged. This means that it includes TypeScript definitions, a format util function and updated dependencies. Documentation will be added soon.
Examples
import datetimeDifference from "datetime-difference";
const date1 = new Date("12/17/2016, 05:23:55 PM");
const date2 = new Date("2/21/2017, 07:12:42 AM");
const result = datetimeDifference(date1, date2); /* result is {
"years": 0,
"months": 2,
"days": 3,
"hours": 13,
"minutes": 48,
"seconds": 47,
"milliseconds": 0
} */
const date3 = new Date("1/1/2016, 00:00:00 AM");
const date4 = new Date("1/1/2026, 00:00:00 AM");
const result2 = datetimeDifference(date3, date4); /* result2 is {
"years": 10,
"months": 0,
"days": 0, // 0, because you don't think about leap years as
"hours": 0, // well as about daylight time when counting dates!
"minutes": 0,
"seconds": 0,
"milliseconds": 0
} */
// Another example:
// Get the result in readable format by parsing the resulting object
const readme = Object.keys(result)
.filter(k => !!result[k])
.map(k => `${ result[k] } ${ k }`)
.join(", ");
// readme is "2 months, 3 days, 13 hours, 48 minutes, 47 seconds"Installation
The datetime-difference is shipped in a form of JavaScript module. Install it from npm:
npm install --save datetime-difference