# Numeric Transformers

Numeric transformers can be used on the source type of `Number` - `Int`, `Float` or `Double`. Following transformers are available:

# `addedBy`

Returns result of the addition of the source and `value`. `value` is considered `Double`.

• Usage: `.addedBy(value)`

• Example usage: `value.addedBy(15.5)`

• Example return: `10` to `25.5`

# `dividedBy`

Returns result of the division of the source and `value`. `value` is considered `Double`. Note: Division by zero is handled gracefully, produces zero, and doesn't throw an error.

• Usage: `.dividedBy(value)`

• Example usage: `value.dividedBy(2.5)`

• Example return: `5` to `2`

# `multipliedBy`

Returns result of multiplication of the source and `value`. `value` is considered `Double`.

• Usage: `.multipliedBy(value)`

• Example usage: `value.multipliedBy(4)`

• Example return: `2` to `8`

# `subtractedBy`

Returns result of subtraction of the source and `value`. `value` is considered `Double`.

• Usage: `.subtractedBy(value)`

• Example usage: `value.subtractedBy(2)`

• Example return: `25` to `23`

# `rounded`

Returns the source rounded to specified number of fractions. `value` must be `Int`.

• Usage: `.rounded(fractions)`

• Example usage: `value.rounded(1)`

• Example return: `1.11` to `1` or `1.16` to `1.2`

# `ceiled`

Returns the next highest `Int` by rounding up the source if necessary.

• Usage: `.ceiled()`

• Example usage: `value.ceiled()`

• Example return: `1.78` to `2` or `-3.14` to `-3`

# `absolute`

Returns absolute source

• Usage: `.default(value)`

• Example usage: `value.default("Empty")`

• Example return: `` to`Empty`

# `positive`

Returns the source that is either the same if it was `>0`, or multiplied by `-1` if it was `<0`.

• Usage: `.positive()`

• Example usage: `value.positive()`

• Example return: `-1` to `1` or `2` to -2`

# `negative`

Returns the source that is either the same if it was `<0`, or multiplied by `-1` if it was `>0`.

• Usage: `.negative()`

• Example usage: `value.negative()`

• Example return: `1` to `-1` or `-2` to `-2`

# `formatDate`

Returns formatted date. The source must be `Int` holding value of standard time interval since 1970 (Unix epoch time).

• Usage: `.formatDate(format)`

• Example usage: `value.formatDate("YYYY-MM-DD")`

• Example return: `1587490511` to `2020-04-21`