Прикладной код

Функция «ФорматВалюта»

Функция «ФорматВалюта»

Форматирует сумму по переданным параметрам. Используется как расширенная функция «ФорматДеньги» с поддержкой форматной строки любой валюты. Форматная строка может содержать параметрами для основных валют — 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 копеек) '