Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

Returns the time instant resulting from adding offset milliseconds to base_instant within schedule calendar in a specific timezone.


Code Block
languagebash
titleSyntax
linenumberstrue
addTime(base_instant, offset, calendarName, timeZone) #Output: Number


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
addTime(2017/12/04 01:00, 8 * {HOUR} + 31 * {MINUTE}, "my_schedulecalendarName", LOCAL)


This example returns: "2017/12/04 17:00"



Code Block
languagebash
linenumberstrue
addTime(2017/04/20 20:30, - 5 * {HOUR}, "my_schedulecalendarName", LOCAL)


This example returns: "2017/04/20 13:00"

Info

Since version 2.2.41 negative offset values are supported.




UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
base_instant

Status
subtletrue
titlenumber


offset

Status
subtletrue
titlenumber


calendarName

Status
subtletrue
titletext

The name of the used JWT calendar.
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
sizemedium
typeinfo

Variant of the function where you can additionally define additional terms, which is a string containing extra Schedules Definition Grammar that extra JWT calendar. that will be attached to the schedulecalendar.

This functions is useful to add personal holidays to an existing schedulecalendar.


Code Block
languagebash
titleSyntax
linenumberstrue
addTime(base_instant, offset, calendarName, additional_terms, timeZone) #Output: Number


UI Expand
titleExamples


Parser expressionDescription

Example without an additional term:

Code Block
languagebash
linenumberstrue
addTime(2017/12/01 9:00, 25 * {HOUR}, "my_schedule-calendar", LOCAL)


This example returns: "2017/12/05 18:00"

Example with additional term:

Code Block
languagebash
linenumberstrue
addTime(2017/12/01 9:00, 25 * {HOUR}, "my_schedule-calendar", "2017/12/04 {;}", LOCAL)


This example returns: "2017/12/06 18:00"



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
base_instant

Status
subtletrue
titlenumber


offset

Status
subtletrue
titlenumber


calendarName

Status
subtletrue
titletext

The name of the used JWT calendar.
additional_terms

Status
subtletrue
titletext

A text containing extra JWT calendar.
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 ore Date Time Picker.

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



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


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

Status
subtletrue
titlenumber

Available since

Status
subtletrue
colourRed
titleneeds lookup

Label