View Source

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.

formatDuration(duration) #Output: Text

Parser expression

Description

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.

Parameters used in this function

Parameter	Input (data type)	Description
`duration`		A number representing a duration (in milliseconds) or the calculation of a duration.

This function returns a

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`

Use cases and examples

Parser function cloud

Map

Notes

There's not really a workaround for this, because Jira Expressions don't let you calculate the difference between dates, nor working with Duration values.

Also, with our parser we can calculate the difference, but we can't format it.

	Status
Tech review
Style guide

Short description	Returns a duration in text form.
Output
Label