fieldChangeTimes()

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

Syntax

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`	TEXT	Any field code representing a text field or a selectable field.
`condition`	BOOLEAN	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 NUMBER LIST containing the timestamps in ascending order

Variant for numeric / date-time fields.

Syntax

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`	NUMBER	Any field code representing a number field (including dates).
`condition`	BOOLEAN	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 NUMBER LIST containing the timestamps in ascending order

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

Syntax

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`	TEXT	Any field code representing a text field or a selectable field.
`issueList`	ISSUE LIST	A list of issues that will be checked. Learn more about Lists.
`condition`	BOOLEAN	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 TEXT LIST containing the timestamps in ascending order

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

Syntax

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`	NUMBER	Any field code representing a number field (including dates).
`issueList`	ISSUE LIST	A list of issues that will be checked. Learn more about Lists.
`condition`	BOOLEAN	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.