addDays()

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

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

Examples

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.

Additional information

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.

Output

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.


(books) Use cases and examples