1.0.4 • Published 5 years ago

date-diff-js v1.0.4

Weekly downloads
28
License
ISC
Repository
-
Last release
5 years ago

date-diff-js

JavaScript library for getting difference between two dates.

Node.js (Install)

Requirements:

  • Node.js

  • npm (Node.js package manager)

npm install date-diff-js

Or

npm install date-diff-js --save

Usage

Modular include:

const  DATE_DIFF = require("date-diff-js");

Use in method

let  dateDiff = DATE_DIFF(date1, date2, searchString);

Input params

  • date1, date2 => any date object or date string with any format, Default is current datetime

  • searchString => The highest date value you want. Default id 'd' i.e. date

searchString List

Search stringsMeaning
y, Y, Year, YearsYears
m, Month, MonthsMonths
d, D, DaysDays
h, H, HoursHours
M, MinutesMinutes
s, S, SecondsSeconds
ms, MS, MillisecondsMilliseconds
w, W, WeeksWeeks

dateDiff gives a output object

{
	input: 'Input search string',
	output: 'Output value',
	outputs: /* outputs object */
	{
		years: 'years value',
		months: 'months value',
		weeks: 'weeks value',
		days: 'days value',
		hours: 'hours value',
		minutes: 'minutes value',
		seconds: 'seconds value',
		milliseconds: 'milliseconds value'
	},
	totals: /* totals object */
	{
		years: 'Total years diff',
		months: 'Total months diff',
		weeks: 'Total weeks diff',
		days: 'Total days diff',
		minutes: 'Total minutes diff',
		hours: 'Total hours diff',
		seconds: 'Total seconds diff',
		milliseconds: 'Total milliseconds diff',
	}
}

SOME EXAMPLES

1. for getting no of days between two dates

let  diffDays = DATE_DIFF('2019-07-07', '2019-03-03', 'D').output;

console.log(diffDays);//126

2. For getting age ( Ex. birthday July 07, 1991) or year difference

let  dateDiff = DATE_DIFF('1991-07-07', 'Y').outputs;

console.log(dateDiff.years +' years '+ dateDiff.months +' months ' + dateDiff.days +' days');//28 years 0 months 21 days

3. For getting age ( Ex. birthday July 07, 1991) from definite date like Jan 01, 2019

let  dateDiff = DATE_DIFF('1991-07-07', '2019-01-01', 'Y').outputs;

console.log(dateDiff.years +' years '+ dateDiff.months +' months ' + dateDiff.days +' days');//27 years 5 months 25 days

4. For getting time difference in hours

let  timeDiff = DATE_DIFF('2019-01-01 12:40:28', '2019-01-01 23:59:59', 'H').outputs;

console.log(timeDiff.hours +' hours '+ timeDiff.minutes +' minutes ' + timeDiff.seconds +' seconds');//11 hours 19 minutes 31 seconds

5. For getting total difference of two dates in all format like years, months, days etc

let  dateDiff = DATE_DIFF('1991-07-07', '2019-01-01', 'Y').totals;

console.log('Total years '+ dateDiff.years +' years');//Total years: 27 years

console.log('Total months '+ dateDiff.months +' months');//Total months: 329 months

console.log('Total days ' + dateDiff.days +' days');//Total days: 10040 days
1.0.4

5 years ago

1.0.3

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago