Tech review

Style guide



This type of read-only custom field has a value which is dynamically calculated from a custom math/time expression. It can be used to obtain a date-time value depending on the value of other fields in current issue or in any other issues (linked issues, sub-tasks, epics, stories, JQL selected issues, etc).


Configuration

Edit Math/Time Expression

This parameter contains a valid math/time expression that will be calculated each time the value of the field is required.

The math/time expression is expected to return a numeric value that represents a moment in time as the milliseconds elapsed since January 1, 1970, 00:00:00 GMT.

Example: Date-Time of creation of an epic

In this step by step example we will create a calculated number field called "Date-Time creation of Epic" that will return the date-time of creation of the Epic issue. When the current issue does not have an Epic issue, a null is returned and no value is shown.



Create a new Calculated Date-Time Field custom field called "Date-Time Creation of Epic"

Head over to Administration → Issues

→ Custom fields → Add custom Field → Advanced → Calculated Date-Time field (by JWT)



On the configuration screen of the newly created custom field go to Actions and click on Configure


Click on Edit Math/Time Expression


Configure the field by entering a math/time expression. Learn more about JWT expression parser. After the configuration, click on Save

The math expression used in this example is: first(fieldValue({00009}, linkedIssues("has Epic"))) , where {00009} is code for numeric value of Date and time of creation field.



Finally, the configuration of the new custom field should look like this: