seikho / date-equality Goto Github PK

Broader date equality checking and mutating

npm install --save date-equality

In the browser:

<script src="date-equality.js"></script>

Node/RequireJS

// Typescript/ES6
import * as DE from 'date-equality';

// ES5
var DE = require('date-equality');

Returns true if the two provided Date objects are on the same date

function sameDate(left: Date, right: Date): boolean;

Returns true if the two provided Date objects are in the same week

function sameWeek(left: Date, right: Date, startOfWeek?: number): boolean;

Returns true if the two provided Date objects have the same time (second precision)

function sameDateTime(left: Date, right: Date): boolean;

Returns a new Date object that is the start (00h00m00s000ms) of the provided Date object

function floorDay(date: Date): Date;

Returns a new Date object that is the end (23h59m59s999ms) of the provided Date object

function ceilDay(date: Date): Date;

Returns a new Date object that is the beginning of the week and floored (floorDay(Date))

function floorWeek(date: Date, startOfWeek?: number): Date;

Returns a new Date object that is the end of the week and ceiled (ceilDay(Date))

function ceilWeek(date: Date, startOfWeek?: number): Date;

Returns the lower and upper bounds as a DateRange object from an array of Date objects

function dateRange(dates: Array<Date>): DateRange;

Returns true if the provided Date object is in the DateRange provided

function inRange(date: Date, range: DateRange): boolean;

interface DateRange {
    start: Date;
    end: Date;
}