​
Math helper

The math helper performs common arithmetic operations. It can accept integers, decimals or strings as its operands and will always yield a number as its output rather than a string.

Addition, subtraction, multiplication, division and remainder (mod) are supported.

{{math 1 '+' 2}}
{{math 4 '-' 2}}
{{math 2 '*' 3}}
{{math 8 '/' 2}}
{{math 10 '%' 3}}

​
Formatting numbers

The numberFormat helper allows you to specify how numbers are printed. It supports a number of predefined formats, custom format strings and various other options including rounding mode, decimal places and locale.

​
Predefined formats

numberFormat supports the following predefined formats:

  • integer
  • currency
  • percent

Predefined formats can be affected by locale, so it’s usually a good idea to explicitly specify this.

For example, to format a decimal number as currency, specifically British pounds:

{{{numberFormat 123.4567 'currency' 'en_GB'}}}

Output: £123.46.

Alternatively, if we wanted to output the number as a percentage:

{{{numberFormat 123.4567 'percent' 'en_GB'}}}

Output: 12,346%.

​
Custom format string

For maximum control over the number format you can specify a format string:

{{{numberFormat 123.4567 '###.000000' 'en_GB'}}}

Output: 123.456700.

See the Java DecimalFormat documentation for details on how to use format strings.

​
Configuring number of digits

Separate from the format parameter, the number of digits before and after the decimal place can be bounded using one or more of four parameters: maximumFractionDigits, minimumFractionDigits, maximumIntegerDigits, minimumIntegerDigits.

{{{numberFormat 1234.567 maximumIntegerDigits=3 minimumFractionDigits=6}}}

Output: 234.567000.

​
Disabling grouping

By default numberFormat will insert commas, periods etc. per the locale between groups of digits e.g. 1,234.5.

This behaviour can be disabled with groupingUsed.

{{{numberFormat 12345.678 groupingUsed=false}}}

Output: 12345.678.

​
Rounding mode

The roundingMode parameter affects how numbers will be rounded up or down when it’s necessary to do so.

For instance, to always round down:

{{{numberFormat 1.239 roundingMode='down' maximumFractionDigits=2}}}

Output: 1.23.

Available rounding modes are:

  • up
  • down
  • half_up
  • half_down
  • half_even
  • ceiling
  • floor.

See the Java RoundingMode documentation for the exact meaning of each of these.