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 |