add
function add(count: number, unit: TimeUnit): Chronosis
Adds count
of unit
to the contained date, returning a new object.
const now = new Chronosis()
// Adds 1 day to the current date.
const tomorrow = now.add(1, 'day')
Edge Cases
If count
isn't a number or unit
isn't a valid TimeUnit
, this function returns an invalid date.
const invalid = now.add(1, 'invalid')
const also_invalid = now.add([], 'month')
const really_invalid = now.add([], 'invalid')
If called with a value greater than can fit in the unit (e.g. 130 seconds), the value wraps around to the next unit.
// Adds 2 minutes and 10 seconds to the current date.
const later = now.add(130, 'seconds')
If called without a unit
, the unit is assumed to be milliseconds.
// Adds 1000 milliseconds to the current date.
const soon = now.add(1000)