fieldChangeTimes()

Text field

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

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

Examples

Parser expression

Description

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

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

Additional information

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.

Output

This function returns a Number list containing the timestamps in ascending order


Number field

Variant for numeric / date-time fields.

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

Examples

Parser expression

Description

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

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

Additional information

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.

Output

This function returns a Number list containing the timestamps in ascending order


Text field issue list

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

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

Examples

Parser expression

Description

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

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

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

Additional information

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.

Output

This function returns a text list containing the timestamps in ascending order


Number field issue list

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

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

Examples

Parser expression

Description

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

Bash
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

Additional information

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.

Output

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


(books) Use cases and examples