View Source

This function returns the timestamps of when a text field was changed satisfying a certain condition.

fieldChangeTimes(textField, condition) #Output: Number list

Parser expression

Description

fieldChangeTimes(%{issue.summary}, ^0% !~~ "IMPORTANT" AND ^1% ~~ "IMPORTANT")

This example returns the list of timestamps of when the word "IMPORTANT" has been added to the current issue's summary ignoring the case.

fieldChangeTimes(%{issue.priority}, ^0% not in ["Critical", "High"] AND ^1% in ["Critical", "High"])

This example returns the list of timestamps of when the current issue's priority has been changed to Critical or High.

Parameters used in this function

Parameter	Input (data type)	Description
`textField`		Any field code representing a text field or a selectable field.
`condition`		The condition is used to check the field value before and after the field change. The text value before the change is represented by `^0%`, and by `^1%` after the change.

This function returns a containing the timestamps in ascending order

Variant for numeric / date-time fields.

fieldChangeTimes(numberField, condition) #Output: Number list

Parser expression

Description

fieldChangeTimes(issue.dueDate, ^0 < ^1)

This example returns the list of timestamps of when the Due date has been increased (updated to a higher value).

fieldChangeTimes({issue.cf10001}, abs(^0 - ^1) / ^0 >= 0.25)

This example returns the list of timestamps of when a number field called Passengers (with the custom field ID 10001) has been edited with a variation of at least 25% over its previous value.

Parameters used in this function

Parameter	Input (data type)	Description
`numberField`		Any field code representing a number field (including dates).
`condition`		The condition is used to check the field value before and after the field change. The number value before the change is represented by `^0`, and by `^1` after the change.

This function returns a containing the timestamps in ascending order

Variant for text fields in multiple issues from a given issue list.

fieldChangeTimes(textField, issueList, condition) #Output: Number list

Parser expression

Description

fieldChangeTimes(%{issue.summary}, subtasks(), ^0% !~~ "IMPORTANT" AND ^1% ~~ "IMPORTANT")

This example returns the list of timestamps of when the word "IMPORTANT" has been added the the summary of all current sub-tasks, ignoring the case.

fieldChangeTimes(%{issue.priority}, epic(), ^0% = null AND ^1% != null)

This example returns the list of timestamps of when the issue priority of the current issue's epic has been set.

fieldChangeTimes(%{issue.priority}, linkedIssues("is blocked by"), ^0% not in ["Critical", "High"] AND ^1% in ["Critical", "High"])

This example returns the list of timestamps of when the priority in all blocking linked issues has become Critical or High.

Parameters used in this function

Parameter	Input (data type)	Description
`textField`		Any field code representing a text field or a selectable field.
`issueList`		A list of issues that will be checked. Learn more about Lists.
`condition`		The condition is used to check the field value before and after the field change. The text value before the change is represented by `^0%`, and by `^1%` after the change.

This function returns a containing the timestamps in ascending order

Variant for numeric / date-time fields in multiple issues from a given issue list.

fieldChangeTimes(numberField, issueList, condition) #Output: Number list

Parser expression

Description

fieldChangeTimes({issue.dueDate}, subtasks(), ^0 < ^1)

This example returns the list of timestamps of when the Due Date has been edited to a higher value in any of the current sub-tasks.

fieldChangeTimes({issue.cf10001}, epic(), abs(^0 - ^1) / ^0 >= 0.25)

This example returns the list of timestamps when a number field called Passengers (field code {10001}) in the current issue's epic has been edited with a variation of at least 25% over its previous value

Parameters used in this function

Parameter	Input (data type)	Description
`numberField`		Any field code representing a number field (including dates).
`issueList`		A list of issues that will be checked. Learn more about Lists.
`condition`		The condition is used to check the field value before and after the field change. The number value before the change is represented by `^0`, and by `^1` after the change.

This function returns a containing the timestamps in the order of issue appearance

Use cases and examples

Parser function cloud
Map
Notes	There is no way to know when a field has changed using Jira Expressions.

	Status
Tech review
Style guide

Short description	Returns the timestamps of when a field has changed satisfying a certain condition.
Output
Label