Versions Compared

Key

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


Page properties
hiddentrue



Status
Tech review

Status
colourYellow
titletodoReady for review

Style guide

Status
colourYellow
titletodoReady for review

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



Page properties
hiddentrue


Short description

Returns any given date in text form

Output

Status
subtletrue
titletext




UI Text Box
sizemedium
typeinfo

Returns any given date in text form


Code Block
languagebash
titleSyntax
linenumberstrue
dateTimeToString(timestamp, timeZone, language) #Output: Text


UI Expand
titleExamples


Parser ExpressionDescription


Code Block
languagebash
linenumberstrue
dateTimeToString({issue.created}, LOCAL, USER_LANG)


This function will take the timestamp (date-time in milliseconds) and translates it to a user friendly text, displayed in the entered language's format.



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).
timeZone

Status
subtletrue
titletimezone

The time zone used for the translation. 

language

Status
subtletrue
titleLanguage

  •  Christian Czaia do we already have some explanation for the language parameter?



UI Expand
titleOutput

The function returns a

Status
subtletrue
titletext
.

UI Text Box
typetip

This function is useful in the Update Field Action to represent as a text the result of a time expression.





UI Text Box
sizemedium
typeinfo

The function returns any given date in text form with a custom format according to the date time pattern.


Code Block
languagebash
titleSyntax
linenumberstrue
 dateTimeToString(timestamp, dateTimePattern, language) #Output: Text


UI Expand
titleExample


Parser expressionDescription


Code Block
languagebash
linenumberstrue
dateTimeToString({issue.created}, "yyyy.MM.dd 'at' HH:mm:ss", USER_LANG)


This function takes the issue's creation date (in milliseconds) and translates it to a text by using the given date time pattern.



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).
dateTimePattern

Status
subtletrue
titletext

A date time pattern in text form according to the Java Date time pattern.

language

Status
subtletrue
titlelanguage




UI Expand
titleOutput

The function returns a

Status
subtletrue
titletext
.

UI Text Box
typetip

This function is useful in the Update Field Action to represent as a text the result of a time expression.





UI Text Box
sizemedium
typeinfo

The function returns any given date in text form with a custom format according to the date time pattern. Additionally you can specify a time zone.


Code Block
languagebash
titleSyntax
linenumberstrue
 dateTimeToString(timestamp, dateTimePattern, timeZone, language) #Output: Text


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
dateTimeToString(0, "yyyy.MM.dd 'at' HH:mm:ss", GMT, USER_LANG)


The function will return a

Status
subtletrue
titletext
: "1970.01.01 at 00:00:00"


Code Block
languagebash
linenumberstrue
dateTimeToString(0, "yyyy.MM.dd 'at' HH:mm:ss", MST, USER_LANG)


The function will return a

Status
subtletrue
titletext
: "1969.12.31 at 17:00:00"



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).
dateTimePattern

Status
subtletrue
titlenumber

A date time pattern in text form according to the Java Date time pattern.
timeZone

Status
subtletrue
titletimezone

The time zone used for the calculation. 

language

Status
subtletrue
titlelanguage




UI Expand
titleOutput

The function returns a

Status
subtletrue
titletext
.

UI Text Box
typetip

This function is useful in the Update Field Action to represent as a text the result of a time expression.