Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Text Box
sizemedium
typeinfo

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


Code Block
languagebash
titleSyntax
linenumberstrue
addDays(timestamp, numberOfDays, timeZone) #Output: Number


UI Expand
titleExamples


Parser expressionDescription


Code Block
linenumberstrue
addDays({issue.dueDate}, 2, LOCAL)


This example adds 2 days to the issue's due date. 


Code Block
linenumberstrue
addDays({issue.dueDate}, -2, LOCAL)


This example subtracts 2 days from the issue's due date.


Code Block
linenumberstrue
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.



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
timestamp

Status
subtletrue
titlenumber

The parameter must be valid timestamp. Usually this value is retrieved from a field (e.g. due date, created date).

numberOfDays


Status
subtletrue
titlenumber

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

Status
subtletrue
titletimezone

The time zone used for the calculation. 



UI Expand
titleOutput

This function returns a 

Status
subtletrue
titlenumber
 representing a timestamp

UI Text Box
typetip

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

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_adddays" and space = currentSpace()


Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue
id1


Parser function cloudaddDays()
Map(tick)
Notes




Page properties
hiddentrue


Short descriptionAdds or subtracts days to or from any given date.
Output

Status
subtletrue
titlenumber

Available since

Status
subtletrue
colourRed
titleneeds lookup

Label