Status
Tech review

Style guide




Short description

Returns the timestamp of any given date in text form. 

Output




Returns the full timestamp of any given date in text form. 


dateTimeToString(timestamp, timeZone, language) #Output: Text



Parser ExpressionDescription


dateTimeToString({issue.created}, LOCAL, USER_LANG)


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



Parameters used in this function

ParameterInput (data type)Description
timestamp

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

The time zone used for the translation. 

language

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



The function returns a .

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





Variant where you can additionally define a custom date time pattern.


 dateTimeToString(timestamp, dateTimePattern, language) #Output: Text



Parser expressionDescription


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.



Parameters used in this function

ParameterInput (data type)Description
timestamp

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

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

language




The function returns a .

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





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


 dateTimeToString(timestamp, dateTimePattern, timeZone, language) #Output: Text



Parser expressionDescription


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


The function will return a : "1970.01.01 at 00:00:00"


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


The function will return a : "1969.12.31 at 17:00:00"



Parameters used in this function

ParameterInput (data type)Description
timestamp

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

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

The time zone used for the calculation. 

language




The function returns a .

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