@ryki/datemath NPM

Datemath

Essentially date-fns and duration-fns with more flexibile duration functions. I expect date-fns to eventually catch up on duration functionality but I need something now.

npm install @ryki/datemath

Functions

import { Function } from "@ryki/datemath"

Function	Description
addDurationToDate(`Date`, `Duration`) -> `Date`	Adds duration to a date
subDurationFromDate(`Date`, `Duration`) -> `Date`	Subtracts duration from date
addUnitToDate(`Date`, `Unit`, `Number`) -> `Date`	Adds Number of Units to Date
subUnitFromDate(`Date`, `Unit`, `Number`) -> `Date`	Subtracts Number of Units from Date
durationBetween(`Date`, `Date`) -> `Duration`	Get duration between 2 dates. The earliest date being the first argument.
addDurations(`Duration`, `Duration`) -> `Duration`	Adds 2 durations
subsDurations(`Duration`, `Duration`) -> `Duration`	Subtracts the 2nd duration from the first (1st - 2nd)
multiplyDurationBy(`Duration`, `Number`) -> `Duration`	Multiplies duration by number
divideDurationBy(`Duration`, `Number`) -> `Duration`	Divides duration by number
durationToUnit(`Duration`, `Unit`, `Number`, `Date`) -> `Number`	Converts duration into a number of units or multiples of units. Date is a reference for calculating duration units.
largestWholeUnitBetween(`Date`, `Date`) -> `Duration`	Returns a single unit duration with the largest non-decimal unit. ie. 14 days -> 2 weeks, 15 days -> 15 days, 0.5 days -> 12 hours
normalizeDuration(`Duration`,`Date`) -> `Duration`	Converts duration into simplest possible whole unit form expressed using multiple units
simplifyDuration(`Duration`,`Date`) -> `Duration`	Converts duration into simplest possible who unit form
unitsBetween(`Date`, `Date`, `Unit`, `Number`) -> `Number`	Get number of units or multiples of units between 2 dates.
wholeUnitsBetween(`Date`, `Date`, `Unit`, `Number`) -> `Number`	Get number of whole units or multiples of units between 2 dates.
timeFromDate(`Date`) -> `Duration`	Returns time of day as a duration
smallestTimeUnitFromDate(`Date`) -> `Unit`	Returns smallest unit of time in the time of day