Formatting number values

Values of Number custom fields or number constants may be formatted in email templates in various ways. The key to number formatting is the $!number variable which is an instance of the NumberTool Jira API class. NumberTool provides buit-in styling for formatting numbers but also provides access to Java NumberFormat API which provides ultimate formatting capabilities. Read more about it here.
Formatting with built-in styles
The following is an example of formatting the value of a number field called "My Number Field" in various styles.
#set ($numberValue = $!issue.getCustomFieldValue("My Number field"))
​
Integer: $!number.format("integer",$!numberValue)
​
Number: $!number.format("number",$!numberValue)
​
Currency: $!number.format("currency",$!numberValue)
​
Percent: $!number.format("percent",$!numberValue)
​
Default: $!number.format("default",$!numberValue)
Format with Java Number format
The following is an example of using Java's NumberFormat to render the number value in Japan's currency:
#set ($numberValue = $!issue.getCustomFieldValue("My Number field"))
#set($numberFormat = $!number.getNumberFormat("currency", $!templateSupport.getLocale("jp_JP")))
​
Currency in Japan: $!numberFormat.format($numberValue)

Velocity Context in email templates

Searching for issues in email templates

Last modified 8mo ago

Copy link

Outline

Formatting with built-in styles

Format with Java Number format