> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiremock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Response Templating - Number Helpers

> Working with numbers

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

```handlebars theme={null}
{{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:

```handlebars theme={null}
{{{numberFormat 123.4567 'currency' 'en_GB'}}}
```

Output: `£123.46`.

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

```handlebars theme={null}
{{{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:

```handlebars theme={null}
{{{numberFormat 123.4567 '###.000000' 'en_GB'}}}
```

Output: `123.456700`.

See the [Java DecimalFormat documentation](https://docs.oracle.com/javase/8/docs/api/java/text/DecimalFormat.html)
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`.

```handlebars theme={null}
{{{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`.

```handlebars theme={null}
{{{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:

```handlebars theme={null}
{{{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](https://docs.oracle.com/javase/8/docs/api/java/math/RoundingMode.html) for the exact meaning of each of these.