Форматирует сумму по переданным параметрам. Используется как расширенная функция «ФорматДеньги» с поддержкой форматной строки любой валюты. Форматная строка может содержать параметрами для основных валют — RUR, USD, EUR, GBP, JPY, а также формат руб./коп..
При работе с печатными формами функция используется в вычисляемых выражениях.
Синтаксис
ФорматВалюта(Значение,Параметры);
Параметры
| Название | Тип | Описание | Обязательно к указанию |
Значение | Число | Сумма для форматирования | Да |
Параметры | Объект | Нет |
Возвращаемое значение
Форматированная строка с суммой в указанной валюте.
Пример
// Вывести сумму в формате по умолчанию
return ФорматВалюта(Документ.Сумма); // '1234руб. 56коп.'
// Вывести сумму с символом валюты "Рубль", без разделения групп разрядов
var Параметры = {
'КодISO': 'RUR',
'РазделятьТриплеты': false
};
return ФорматВалюта(Документ.Сумма, Параметры); // '₽ 1234.56'
// Вывести сумму с символом валюты "Доллар"
var Параметры = {
'КодISO': 'USD'
};
return ФорматВалюта(Документ.Сумма, Параметры); // '$ 1 234.56'
// Вывести сумму в заданном формате, используя пользовательские символы валют
var Параметры = {
'Формат': '{curr_int} {int}={frac}',
'СписокВалют': ['%', '']
};
return ФорматВалюта(Документ.Сумма, Параметры); // '% 12345=67'
// Вывести сумму в формате "прописью"
var Параметры = {
'Прописью': true
};
return ФорматВалюта(Документ.Сумма, Параметры); // '35 руб. 00 коп. (Тридцать пять рублей)'
// Вывести сумму в формате "прописью" с отображением нулевых копеек
var Параметры = {
'Прописью': true,
'ПоказыватьНулевоеДробное': true
};
return ФорматВалюта(Документ.Сумма, Параметры); // '35 руб. 00 коп. (Тридцать пять рублей 00 копеек) '