finity-js

Without dependencies. Really lightweight date helpers library

Usage:

var finity = require('finity-js');
 
// Basic date formatter usage
finity.format(new Date(), 'DD (ddd) MMM YYYY');
// 30 (Fri) Sep 2016
 
// One more format date case
var ru = require('finity-js/locales/ru');
finity.setLocale(ru); // set Russian locale
finity.format(new Date(), 'DD (dddd) MMMM YYYY', true); // use genitive case
// 30 (Пятница) Сентября 2016
 
// Basic parser usage
finity.parse('2016-Jan-1st').toDateString()
// Fri Jan 01 2016
 
// You can try to parse date few times by array. (Here first format will be ignored)
finity.parse('2016-10-20 10:36:30pm', ['MM-DD ha', 'YYYY-MM-DD hh:mm:ssa', 'YYYY-M-D'])
// Returns new Date instance: Thu Oct 20 2016 22:36:30 GMT+0700 (ICT)
 
// Parse with known date string mask
finity.parse('08-09-2015', 'DD-MM-YYYY').toDateString()
// Tue Sep 08 2015
finity.parse('23rd January 999', 'Do MMMM YYYY').toDateString()
// Wed Jan 23  999

Try it on runkit.com

Patterns for formatting and parsing date

Pattern	Result
YYYY	1990 1991 1992 ..
YY	90 91 92 ..
MMMM	January February March ..
MMM	Jan Feb Mar ..
MM	01 02 03 ..
M	1 2 3 ..
DD	01 02 03 ..
Do	1st 2nd 3rd ..
D	1 2 3 ..
dddd	Sunday Monday Tuesday ..
ddd	Sun Mon Tue ..
H	0 1 2 .. 23
HH	00 01 02 .. 23
h	1 2 3 .. 12
hh	01 02 03 .. 12
k	1 2 3 .. 24
kk	01 02 03 .. 24
m	1 2 3 .. 59
mm	01 02 03 .. 59
s	1 2 3 .. 59
ss	01 02 03 .. 59

Other date-helpers methods

diff

Subtracts the first element of the second
Arguments

• Date: The first date
• Date: The last date
• Boolean(optional): If you need to get absolute value

Returns:
Number: Returns the difference in days

daysInMonth

Calculates quantity days in month
Arguments

• Date: The Date instance with month to calculate

Returns:

• Number: Returns day number of last day in month

addDays

Creates a new Date instance with added days
Arguments

• Date: Date instance to process
• Number: Number of days to add

Returns:
Number: Returns new Date instance with added days

addMonths

Creates a new Date instance with added months
Arguments

• Date: Date instance to process
• Number: Number of months to add

Returns:
Number: Returns new Date instance with added months

addYears

Creates a new Date instance with added years
Arguments

• Date: Date instance to process
• Number: Number of years to add

Returns:
Number: Returns new Date instance with added years

getDatesRange

Creates an array of Dates between two Dates
Arguments

• Date: Date instance from
• Date: Date instance to

Returns:
Array: Returns an array

getDatesMonthRange

Creates an array of Dates between two Dates by months
Arguments

• Date: Date from
• Date: Date to

Returns:
Array: Array of Dates by months

isLeap

Returns is leap year or not
Arguments

• Date

Returns:
Boolean

isEqual

Arguments

• Date
• Date
• String — type of check: year or month or day or hour or minute or second

Returns:
Boolean

isEqualDates

Returns true if days, months and years is equals of both dates
Arguments

• Date
• Date

Returns:
Boolean

isEqualMonths

Returns true if months and years is equals of both dates
Arguments

• Date
• Date

Returns:
Boolean

setLocale

Setting locale for formatting
Arguments

• Object: keys: {previousMonth (Array), nextMonth (Array), months (Array), weekdays (Array), weekdaysShort (Array)}

lastMonthDate

Creates a new Date instance with last day of month
Arguments

• Date

Returns:
Date

getMonthDates

Creates an array with Dates of month
Arguments

• Date

Returns:
Date

isDateInRange

Returns true if date in first argument is >= then date in second argument and <= then date in third argument
Comparing only by days, not by hours
Arguments

• Date The date to process
• Date Min date
• Date Max date

Returns:
Boolean

getLocale

Returns current locale
Arguments

• String(optional): key of locale

Returns: *

utc

Returns new Date instance with UTC time Arguments

• Date(optional): Date to process

Returns: Date

Returns:
Object: Returns object(locale) if called without key
*: Returns value of locale by object key