date-arithmetic

Date Arthmetic

A simple object containing some date math utils in the spirit of Moment.js. Unlike Moment this module, returns real date objects, so it isn't chainable.

var dateMath = require('date-arithmetic')

var date = dateMath.month(new Date) 

API

all api methods return a new date. Date objects are never mutated.

Localization

startOfWeek() method returns a number (usually 0-6) indicating the start of the week day. Override this function to specify a a culture specific start day. the default is 0.

Accessors

get and set date part values.

• dateMath.milliseconds(date, [value])
• dateMath.seconds(date, [value])
• dateMath.minutes(date, [value])
• dateMath.hours(date, [value])
• dateMath.date(date, [value])
• dateMath.day(date, [value])
• dateMath.weekday(date, [value])
• dateMath.month(date, [value])
• dateMath.year(date, [value])
• dateMath.decade(date, [value])
• dateMath.century(date, [value])

startOf(data, unit)

return a new date with the relevent date parts zero'd out.

dateMath.startOf(new Date, 'day') // -> no time components

Valid unit values are; "second", "minutes", "hours", "day", "week", "month", "year", "decade", "century"

endOf(data, unit)

the opposite of startOf

dateMath.endOf(new Date, 'day') // -> one millisecond before tomorrow

Valid unit values are; "milliseconds", "second", "minutes", "hours", "day", "weekday", "month", "year", "decade", "century".

Math Functions

Arithmetic functions

• dateMath.add(date, value, unit)
• dateMath.subtract(date, value, unit)
• dateMath.eq(dateA, dateB)
• dateMath.neq(dateA, dateB)
• dateMath.gte(dateA, dateB)
• dateMath.gt(dateA, dateB)
• dateMath.lte(dateA, dateB)
• dateMath.lt(dateA, dateB)
• dateMath.inRange(day, min, max, unit)
• dateMath.min(dateA, dateB, dateN)
• dateMath.max(dateA, dateB, dateN)

Valid unit values are; "second", "minutes", "hours", "day", "week", "month", "year", "decade", "century"

Similar packages

Other packages similar to date-arithmetic

moment

Moment.js is a widely-used library for parsing, validating, manipulating, and formatting dates in JavaScript. It offers a comprehensive set of features for date manipulation, similar to date-arithmetic, but also includes extensive formatting and parsing capabilities.

date-fns

date-fns provides a comprehensive set of functions for working with dates in JavaScript. It is modular, allowing you to import only the functions you need, which can result in smaller bundle sizes compared to Moment.js. date-fns offers similar arithmetic operations as date-arithmetic but with a more functional programming approach.

luxon

Luxon is a modern JavaScript library for working with dates and times. It is built on top of the native JavaScript Date and Intl APIs and provides a more modern and immutable API compared to Moment.js. Luxon offers similar date manipulation capabilities as date-arithmetic but with additional features like time zones and localization.