This function returns a text representing a time duration (in milliseconds), i.e. the difference between two date-time values, using the current user's language.

Syntax
formatDuration(duration) #Output: Text
Examples
Parser expressionDescription
formatDuration(2020-01-31 11:30 - 2020-01-30 00:00)

This example returns:

1 day, 11 hours, 30 minutes

(Given the user language is set to English.)

formatDuration(60000)

This example returns:

1 minute

(Given the user language is set to English.)

formatDuration({issue.resolutionDate} - {issue.created})

This example returns the time between the creation and resolution of an issue.


Additional information

Parameters used in this function

ParameterInput (data type)Description
duration

NUMBER

A number representing a duration (in milliseconds) or the calculation of a duration.
Output

This function returns a TEXT

This function is extremely helpful when you want to automatically calculate the duration in JWT calculated text fields.

If you prefer a more comprehensive representation, please see shortFormatDuration().

FunctionOutput
shortFormatDuration()1d 11h 30m
formatDuration() 1 day, 11 hours, 30 minutes


Use cases and examples