Info | ||
---|---|---|
| ||
Please visit our Support Page for more information. |
...
where <field_ID_or_Name> is either a built-in JIRA or custom field ID (the latter in the form customfield_nnnnn), or a field name. See this page for details.
You can also access the JIRA Issue object using the issueObject
variable.
...
Code Block |
---|
numberTool.format(value) |
Example
To display an icon to the left of the field value depending on the field value:
...
Anchor | ||||
---|---|---|---|---|
|
- Create a new custom field, choosing "Calculated Date/Time Field" for its type.
- During step 2, in the Description field, include the calculation formula using the syntax described below.
- Re-index your data, as JIRA will kindly suggest you to.
Formula syntax
The formula is written using the BeanShell language, and should be included in the field description inside an html comment (so that it remains invisible when showing the field description), preceded by the following keyword: @@Formula: (note the colon at the end). See Calculated Number Field above for details.
Note that you must make sure the formula returns a java.util.Date, or null.
Custom formatting
You can also specify a date/time format for the value of the Calculated Date/Time field. In the Description field, add the name of the date/time format using the following syntax:
Code Block |
---|
<!-- @@Format: <formatformat_name>name --> |
where <formatformat_name>
is name
is one of the constants found here: https://developer.atlassian.com/static/javadoc/jira/reference/com/atlassian/jira/datetime/DateTimeStyle.html
...
Code Block |
---|
<!-- @@ColFormat: <formatformat_name>name --> |
Anchor | ||||
---|---|---|---|---|
|
...
If you don't specify anything, the last execution will be captured.
Custom formatting
You can also specify a date/time format for the value of the Calculated Date/Time field. In the Description field, add the name of the date/time format using the following syntax:
Code Block |
---|
<!-- @@Format: <formatformat_name>name --> |
where <formatformat_name>
is name
is one of the constants found here: https://developer.atlassian.com/static/javadoc/jira/reference/com/atlassian/jira/datetime/DateTimeStyle.html
...
Code Block |
---|
<!-- @@ColFormat: <formatformat_name>name --> |
Anchor | ||||
---|---|---|---|---|
|
...
The field name (indicated as <field-name>
above) should be specified as it appears in the "history" tab, except for system fields for which the name should be as listed here.
You can naturally include the real description of the custom field as well. For example:
...
Custom formatting
You can also specify a date/time format for the value of the Calculated Date/Time field. In the Description field, add the name of the date/time format using the following syntax:
Code Block |
---|
<!-- @@Format: <formatformat_name>name --> |
where <formatformat_name>name
is one of the constants found here: https://developer.atlassian.com/static/javadoc/jira/reference/com/atlassian/jira/datetime/DateTimeStyle.html
...
Code Block |
---|
<!-- @@ColFormat: <formatformat_name>name --> |
Anchor | ||||
---|---|---|---|---|
|
...
The field name (indicated as <field-name>
above) should be specified as it appears in the "history" tab, except for system fields for which the name should be as listed here.
You can naturally include the real description of the custom field as well. For example:
...