# Системные функции: Форматирование десятичного числа

Source: https://docs.botman.pro/a/135-sistemnye-funktsii-formatirovanie-desyatichnogo-chisla

Функция «Форматирование десятичного числа» помогает боту красиво отображать числа: добавлять разделители тысяч, нужное количество знаков после запятой и убирать лишние нули.

**Например:**

- 1234\.5 → 1 234.50
- 5 → 5.00
- 5\.1 → 5.1

---

## Где можно использовать

Эта функция доступна почти везде, где можно вставить переменную:

- шаги «Сообщение», «Действие», блок «Вопрос» и др;
- шаблоны быстрых ответов;
- запросы к ChatGPT и интеграции.

**Как вставить функцию**

Откройте нужный шаг (например, «Сообщение»):\
Нажмите "</> Выбор переменных и функций" ⭢ вкладка Системные функции ⭢ форматирование десятичного числа.

Вставится метка функции, и откроется окно с настройками.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/77d53506ef3a6015c9be7564600f44130f7dce4d43755ec5e8ed98fe917ab00a.png)

---

## Как заполнить настройки

После вставки вы увидите окно с тремя основными полями:

**1️⃣ Число для форматирования**\
Введите нужное число вручную (например, 1234.5)\
или выберите переменную, где хранится это значение.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/49d0fd0590fc06f7600f8c631115d2cbe86157ef3fc5eb38b145b2ae531e3e6a.png)

**2️⃣ Формат**\
Это шаблон, по которому бот покажет число.\
Вы можете выбрать готовый вариант из списка или ввести свой.

0 — обязательный разряд\
\# — необязательный разряд\
. — разделитель дробной части\
, — разделитель тысяч

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/0b969ea9a1eed087a0461b6f6394e1a1ef6771ebe66fa8fbc0ec0764e88ddf33.png)

**Основные шаблоны:**

| Формат | Как работает | Пример |
| --- | --- | --- |
| 0.00 | Всегда два знака после запятой, даже если нули | 5 → 5.00 |
| 0.# | Один знак, если он есть | 5.1 → 5.1, 5 → 5 |
| #,#. | Добавляет разделители тысяч и до двух знаков | 1234.5 → 1 234.5 |
| #,##0.00 | Разделители тысяч и всегда два знака | 5 → 0.00, 1234 → 1 234.00 |
| 0 | Без дробной части (округление до целого) | 2.7 → 3 |

💡 При наведении на формат в списке подсказка покажет, как он выглядит (как на скрине).\
Это помогает быстро подобрать нужный стиль отображения

**3️⃣ Резервное значение (по желанию)**\
Это «план Б» — если число не получится отформатировать (например, переменная пуста),\
бот покажет это значение вместо ошибки.

---

## Реальные кейсы

**Цены и суммы**\
«Стоимость заказа: `{{decimal_format(1234.5, "0.00")}}` ₽»\
Бот покажет: Стоимость заказа: 1 234.50 ₽.

**Проценты**\
«Ваша скидка: `{{decimal_format({{скидка}}, "0.#")}}` %»\
Если скидка = 7.8, бот покажет 7.8 %; если 8 — просто 8 %.

**Финансовые отчёты**\
`{{decimal_format({{доход}}, "#,##0.00")}}`\
Число отобразится с пробелами или запятыми между тысячами:\
12 345.67 ₽

**Подстраховка**\
`{{decimal_format({{сумма}}, "0.00", 0)}}`\
Если переменная пуста или не число, бот подставит 0,\
чтобы сообщение всё равно выглядело аккуратно

---

**Что важно помнить**

- Вводите дробные части через точку, не запятую (2.5 — ✅, 2,5 — ❌).
- Если вы выбираете переменную, бот подставит её значение при запуске сценария.
- Если ничего не получится посчитать, возвращается резервное значение или 0

---

**Частые вопросы**

**Можно ли задать свой шаблон?**\
Да! Можно написать вручную, например:

- 0\.### — до трёх знаков после запятой;
- \#,###.00 — разделители тысяч и всегда два знака.

**Чем отличается от “Округления числа”?**\
Функция “Округление” просто сокращает дробь,\
а “Форматирование” — ещё и красиво оформляет результат (добавляет пробелы, нули, разделители).

**Что делает резервное значение?**\
Если бот не может посчитать (например, переменная пуста), он покажет это значение вместо ошибки.

**✨ Совет**

Используйте формат 0.00 — он универсален:\
подходит для денег, процентов и любых аккуратных чисел.\
А если хотите красивое отображение больших сумм — попробуйте #,###.##\
(бот сам расставит разделители тысяч).