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

#1. :formatN(precision)

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

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

• precision: Количество десятичных знаков. Для форматов ODS/XLSX количество отображаемых десятичных знаков определяется текстовым редактором; для других форматов используется этот параметр.

#Пример

// Пример окружения: параметры API { "lang": "en-us" }
'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

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

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

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

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