add

Add the specified years, months, weeks, days, hours, minutes and seconds to the given date.

Description

Add the specified years, months, weeks, days, hours, minutes and seconds to the given date.

Usage

// CommonJS
var add = require('date-fns/add')

// ES 2015
import add from 'date-fns/add'

// ESM
import { add } from 'date-fns'

Syntax

add(date, duration)

Arguments

Name	Description
date	the date to be changed
duration	the object with years, months, weeks, days, hours, minutes and seconds to be added. Positive decimals will be rounded using Math.floor, decimals less than zero will be rounded using Math.ceil. Key Description years Amount of years to be added months Amount of months to be added weeks Amount of weeks to be added days Amount of days to be added hours Amount of hours to be added minutes Amount of minutes to be added seconds Amount of seconds to be added All values default to 0

Returns

Description
the new date with the seconds added

Exceptions

Type	Description
TypeError	2 arguments required

Examples

// Add the following duration to 1 September 2014, 10:19:50
const result = add(new Date(2014, 8, 1, 10, 19, 50), {
  years: 2,
  months: 9,
  weeks: 1,
  days: 7,
  hours: 5,
  minutes: 9,
  seconds: 30,
})
//=> Thu Jun 15 2017 15:29:20