Форматирование чисел

1. :formatN(precision)

Описание синтаксиса

Форматирует число в соответствии с настройками локализации.
Параметр:

  • precision: количество знаков после запятой.
    Для форматов ODS/XLSX количество отображаемых знаков после запятой определяется редактором; для остальных форматов используется этот параметр.
Пример
'10':formatN()         // Выводит "10.000"
'1000.456':formatN()   // Выводит "1,000.456"
Результат

Число выводится в соответствии с указанной точностью и форматом локализации.

2. :round(precision)

Описание синтаксиса

Округляет число до указанного количества знаков после запятой.

Пример
10.05123:round(2)      // Выводит 10.05
1.05:round(1)          // Выводит 1.1
Результат

На выходе число, округлённое до заданной точности.

3. :add(value)

Описание синтаксиса

Добавляет указанное значение к текущему числу.
Параметр:

  • value: прибавляемое число.
Пример
1000.4:add(2)         // Выводит 1002.4
'1000.4':add('2')      // Выводит 1002.4
Результат

На выходе сумма текущего числа и указанного значения.

4. :sub(value)

Описание синтаксиса

Вычитает указанное значение из текущего числа.
Параметр:

  • value: вычитаемое число.
Пример
1000.4:sub(2)         // Выводит 998.4
'1000.4':sub('2')      // Выводит 998.4
Результат

На выходе разность текущего числа и указанного значения.

5. :mul(value)

Описание синтаксиса

Умножает текущее число на указанное значение.
Параметр:

  • value: множитель.
Пример
1000.4:mul(2)         // Выводит 2000.8
'1000.4':mul('2')      // Выводит 2000.8
Результат

На выходе произведение текущего числа и указанного значения.

6. :div(value)

Описание синтаксиса

Делит текущее число на указанное значение.
Параметр:

  • value: делитель.
Пример
1000.4:div(2)         // Выводит 500.2
'1000.4':div('2')      // Выводит 500.2
Результат

На выходе результат деления.

7. :mod(value)

Описание синтаксиса

Вычисляет остаток от деления текущего числа на указанное значение.
Параметр:

  • value: делитель для операции остатка.
Пример
4:mod(2)              // Выводит 0
3:mod(2)              // Выводит 1
Результат

На выходе остаток от операции деления.

8. :abs

Описание синтаксиса

Возвращает абсолютное значение числа.

Пример
-10:abs()             // Выводит 10
-10.54:abs()          // Выводит 10.54
10.54:abs()           // Выводит 10.54
'-200':abs()          // Выводит 200
Результат

На выходе абсолютное значение входного числа.

9. :ceil

Описание синтаксиса

Округляет число вверх до наименьшего целого, которое больше или равно текущему числу.

Пример
10.05123:ceil()       // Выводит 11
1.05:ceil()           // Выводит 2
-1.05:ceil()          // Выводит -1
Результат

На выходе число, округлённое вверх до ближайшего целого.

10. :floor

Описание синтаксиса

Округляет число вниз до наибольшего целого, которое меньше или равно текущему числу.

Пример
10.05123:floor()      // Выводит 10
1.05:floor()          // Выводит 1
-1.05:floor()         // Выводит -2
Результат

На выходе число, округлённое вниз до ближайшего целого.

11. :int

Описание синтаксиса

Преобразует число в целое (не рекомендуется к использованию).

Пример и результат

Зависит от конкретного сценария преобразования.

12. :toEN

Описание синтаксиса

Преобразует число в английский формат (с . в качестве десятичного разделителя). Не рекомендуется к использованию.

Пример и результат

Зависит от конкретного сценария преобразования.

13. :toFixed

Описание синтаксиса

Преобразует число в строку, оставляя только указанное число знаков после запятой. Не рекомендуется к использованию.

Пример и результат

Зависит от конкретного сценария преобразования.

14. :toFR

Описание синтаксиса

Преобразует число во французский формат (с , в качестве десятичного разделителя). Не рекомендуется к использованию.

Пример и результат

Зависит от конкретного сценария преобразования.