Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

If time_instant doesn't belong to the calendar, then returns closer time in the future that belongs to it, otherwise returns time_instant.


Code Block
languagebash
titleSyntax
linenumberstrue
nextTime(time_instant, calendarName, timeZone) #Output: Number


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
nextTime(2017/12/01 01:00, "my-calendar", LOCAL)


This example returns: "2017/12/01 08:00"


Code Block
languagebash
linenumberstrue
nextTime(2017/12/01 15:00, "my-calendar", LOCAL)


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



UI Expand
titleAdditional information

Parameters used in this function:

ParameterInput(data type)Description
time_instant

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 functions 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 text containing extra JWT calendar that will be attached to the calendar.

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


Code Block
languagebash
titleSyntax
linenumberstrue
nextTime(time_instant, calendarName, additional_terms, timeZone) #Output: Number


UI Expand
titleExamples


Parser expressionDescription

Example without an additional term:

Code Block
languagebash
linenumberstrue
nextTime(2017/12/01 15:00, "my-calendar", LOCAL)


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

Example with additional term:

Code Block
languagebash
linenumberstrue
nextTime(2017/12/01 15:00, "my-calendar", "2017/12/04 {;}", LOCAL)


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



UI Expand
titleAdditional information

Parameters used in this function:

ParameterInput(data type)Description
time_instant

Status
subtletrue
titlenumber


calendarName

Status
subtletrue
titletext

The name of the used JWT calendar.
additional_terms

Status
subtletrue
titletext

A text containing extra JWT calendars.
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
typeinfo

In the examples we have used the following definition for "my-calendar":

Code Block
languagebash
MON - THU {
   08:00 - 15:00,
   16:00 - 19:30;
}
 
FRI {
    08:00 - 15:00;
}



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
titletodo

Style guide

Status
titletodo

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



Page properties
hiddentrue


Short descriptionGet the future time that belongs to a specific calendar.
Output

Status
subtletrue
titlenumber

Available since

Status
subtletrue
colourRed
titleneeds lookup

Label