Модификатор
inWordsCurrency переводит
число в строку прописью с указанием валюты.
Используется в счетах, договорах, актах, платежных документах и любых финансовых шаблонах, где требуется сумма
цифрами и словами.
Базовый синтаксис:
{{ number | inWordsCurrency('CODE') }}
- number — числовое значение (обычно пользовательское поле сделки)
- CODE — код валюты
Поддерживаемые валюты (примеры):
доллар — {{XXX | inWordsCurrency('USD')}}
гривны — {{XXX | inWordsCurrency('UAH')}}
тенге — {{XXX | inWordsCurrency('KZT')}}
евро — {{XXX | inWordsCurrency('EUR')}}
белорусский рубль — {{XXX | inWordsCurrency('BYN')}}
Где XXX — это ID пользовательского поля, например lead.cf.XXX.
Пример результата:
Значение поля: 285.99
{{lead.cf.XXX | inWordsCurrency('USD')}} → двести восемьдесят пять долларов девяносто девять центов
{{lead.cf.XXX | inWordsCurrency('UAH')}} → двести восемьдесят пять гривен девяносто девять копеек
{{lead.cf.XXX | inWordsCurrency('KZT')}} → двести восемьдесят пять тенге девяносто девять тиынов
{{lead.cf.XXX | inWordsCurrency('EUR')}} → двести восемьдесят пять евро девяносто девять евроцентов
{{lead.cf.XXX | inWordsCurrency('BYN')}} → двести восемьдесят пять белорусских рублей девяносто девять копеек
Использование в условиях (выбор валюты)Пример, когда валюта хранится в отдельном поле и нужно вывести сумму прописью в зависимости от значения:
{% for item in lead.cf.2823147 | split(', ') %} {% if item == 'USD' %} {{lead.cf.2823145|inWordsCurrency('USD')}} {% endif %} {% if item == 'RUB' %} {{lead.cf.2823145|inWordsCurrency('RUB')}} {% endif %} {% if item == 'BYN' %} {{lead.cf.2823145|inWordsCurrency('BYN')}} {% endif %} {% if item == 'UAH' %} {{lead.cf.2823145|inWordsCurrency('UAH')}} {% endif %} {% if item == 'KZT' %} {{lead.cf.2823145|inWordsCurrency('KZT')}} {% endif %} {% endfor %}
Разделение числа и прописи валюты
Если нужно разбить число на разряды, а валюту вывести прописью отдельно, используйте два выражения подряд:
{{lead.cf.xxx | pretty('',2) }} {{lead.cf.xxx | inWordsCurrency('RUB', 'C')}}
Результат: 1 002.00 рубля
inWordsCurrency поддерживает
маску форматирования, которая позволяет гибко управлять выводом.
- Значения маски:W — целая часть прописью
- w — целая часть цифрами
- D — дробная часть прописью
- d — дробная часть цифрами
- C — название мажорной единицы (рубль, доллар и т.д.)
- c — название минорной единицы (копейка, цент и т.д.)
Примеры масок (inWordsCurrency):
{{ 12.44 | inWordsCurrency('RUB', 'W C, D c') }} → двенадцать рублей, сорок четыре копейки
{{ 12.44 | inWordsCurrency('RUB', 'W C, d c') }} → двенадцать рублей, 44 копейки
{{ 12.44 | inWordsCurrency('RUB', 'W (w) C, D (d) c') }} → двенадцать (12) рублей, сорок четыре (44) копейки
Поведение по умолчанию
Если маска
не указана, модификатор выводит сумму полностью прописью с валютой и дробной частью - стандартный формат для финансовых документов.
- Важно:работает с числовыми значениями
- идеально подходит для счетов и договоров
- маска позволяет полностью контролировать формат вывода
- можно комбинировать с pretty, round, numberFormat