This function 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.

This example will return:

18/May/20 7:52 AM



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 conversion. 

language

The language used for the conversion. 



This function returns a .

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





Variant where you can additionally define a custom date time pattern (see documentation).


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



Parser expressionDescription


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


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

This example will return:

2020.05.18 at 07:52:02



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 (see documentation).

language

The language used for the conversion. 



This 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 specify a custom format according to the date time pattern and additionally a time zone (see documentation).


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



Parser expressionDescription


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


This example will return:

1970.01.01 at 00:00:00


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


This example will return:

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 (see documentation).
timeZone

The time zone used for the calculation. 

language

The language used for the conversion. 



This function returns a .

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






Status
Tech review

Style guide



Short description

Returns the timestamp of any given date in text form. 

Output

Available since

Label