Даты и суммы в шаблонах Битрикс24: настройка форматирования

Как читается выражение

Общая схема — поле, вертикальная черта и имя фильтра:

{{ deal.opportunity | money }}

Для нескольких фильтров порядок идёт слева направо. Строковые параметры заключаются в прямые кавычки, числовые параметры передаются числами. Не заменяйте кавычки в выражениях типографскими знаками Word.

Даты: месяц и минуты различаются

Пример даты создания задачи внутри таблицы:

{{ item.created_date | date("dd.MM.yyyy HH:mm") }}

Здесь dd — день, MM — месяц, yyyy — год, HH — часы, mm — минуты. Регистр имеет значение. Перепутанные MM и mm могут дать визуально правдоподобный, но неправильный результат.

Форматирование уже существующей даты не означает перевод в другой часовой пояс. Если документ должен показывать определённое местное время, проверьте исходное значение и правила его получения отдельно.

Сумма с валютой, без валюты и прописью

Для учебного значения 1250,5 варианты оформления различаются:

Пример суммы прописью по выбранному итогу:

{{ totals.sum_with_vat | money_words }}

Используйте этот источник только если именно он соответствует нужному итогу документа. Красивое представление не подтверждает, что выбрана правильная сумма с учётом скидок и налогов.

Денежные фильтры приложения используют рубли. Они не выбирают символ по валюте CRM и не выполняют конвертацию. Для валютного документа отдельно задайте и проверьте способ отображения.

Проценты не пересчитываются автоматически

Фильтр percent добавляет знак процента и форматирует число, но не умножает его на сто. Значение 12,5 отображается как 12,50 %, а дробь 0,125 не следует считать готовым источником для 12,5 %.

Перед настройкой выясните, как ставка хранится в вашем поле: процентным числом или долей. Не подменяйте эту проверку визуальным форматированием.

Что проверить в Excel

Оформленная сумма может оказаться текстом. Если документ предназначен для дальнейших вычислений, проверяйте тип ячейки на итоговом XLSX. Значение с символом валюты не стоит без проверки использовать в формулах.

Разделяйте данные для расчёта и данные для печатного отображения. В шаблоне может быть удобно показывать читаемую сумму, но источником итога должна оставаться согласованная логика расчёта.

Контрольный набор значений

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

Сверяйте результат с исходной CRM-карточкой, а не только с учебным примером. После изменения фильтра сформируйте новый файл: ранее полученный документ не переписывается.

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