addDays()

This function adds or subtracts days to or from any given date.

Syntax

addDays(timestamp, numberOfDays, timeZone) #Output: Number

Parser expression	Description
addDays({issue.dueDate}, 2, LOCAL)	This example adds 2 days to the issue's due date.
addDays({issue.dueDate}, -2, LOCAL)	This example subtracts 2 days from the issue's due date.
addDays({issue.cf10100}, -6, USER_LOCAL)	This example subtracts 6 days from a custom date-time field (with the ID 10100). Instead of the Jira server's local time, this example uses the current user's time zone.

Parameters used in this function

Parameter	Input (data type)	Description
`timestamp`	NUMBER	The parameter must be valid timestamp. Usually this value is retrieved from a field (e.g. due date, created date).
`numberOfDays`	NUMBER	The offset in days. Negative values are used to subtract days. Internally JWT multiplies this value with the time macro `{DAY}` to add full days to the timestamp. Learn more about time macros.
`timeZone`	TIMEZONE	The time zone used for the calculation.

This function returns a NUMBER representing a timestamp

The output can be written into any Jira field of type Date Picker or Date Time Picker.

Another very common use case is to use this function in one of the JWT calculated date-time fields.

Use cases and examples

Use case	JWT feature	Workflow function	Field type	Automated action	Parser functions
Set a date on the same week day on alternate weeks		Update or copy field values			addDays() nextDayOfTheWeek() modulus() weekOfTheYear() datePart()
Add comment after seven days in the same status				Add comment action