formatDuration()

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.

Bash
formatDuration(duration) #Output: Text

Examples

Parser expression

Description

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

Bash
formatDuration(60000)

This example returns:

1 minute

(Given the user language is set to English.)

Bash
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

Parameter

Input (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().

Function

Output

shortFormatDuration()

1d 11h 30m

formatDuration()

1 day, 11 hours, 30 minutes


(books) Use cases and examples