Для форматирования ДП типа число и деньги используется модификатор NumberFormat со строкой форматирования, которая может включать в себя различные символы. Самый простой способ форматирования — использование символов N или n для чисел или символов C или c для денег, после которых можно указать число знаков после запятой (если не указано — выводится так, как это число хранится в БД).
Пример записи |
Результат вывода ДП типа "Число"со значением 99,9 |
---|---|
##ExtParam123|NumberFormat:{0:N}## |
99,9 |
##ExtParam123|NumberFormat:{0:N1}## |
99,9 |
##ExtParam123|NumberFormat:{0:N3}## |
99,900 |
##ExtParam123|NumberFormat:{0:C}## |
99,9 ₽ |
##ExtParam123|NumberFormat:{0:C1}## |
99,9 ₽ |
##ExtParam123|NumberFormat:{0:C3}## |
99,900 ₽ |
Дополнение числа нулями и пробелами
Также для задания числового или денежного форматов можно использовать символы 0 или #. Если используется символ 0, то при отсутствии значения на данной позиции будет выведен 0, а если используется символ # — то при отсутствии значения не будет выведено ничего. Поскольку двойной знак решетки ## используется также для задания начала и конца строки форматирования, то чтобы различать эти варианты использования символа, одиночный # предваряется знаком \, вот так: \#.
Пример записи |
Результат вывода ДП типа "Число"со значением 99 |
---|---|
##ExtParam123|NumberFormat:{0:000}## |
099 |
##ExtParam123|NumberFormat:{0:\#}## |
99 |
Вывод дробной части
Для отделения дробной части используется точка. После нее указывается то количество символов 0 или \#, сколько знаков после запятой должно выводиться. Символ, который будет выведен на печать в качестве разделителя дробной части, определяется системными настройками.
Синтаксис: ##Параметр|NumberFormat:{0:0.00}##
Пример записи |
Результат вывода ДП типа "Число"со значением 55,5 |
---|---|
##ExtParam123|NumberFormat:{0:0.00}## |
55,50 |
Разделение на разряды
Для разделения большого числа на разряды (тысячи, миллионы и т.д.) используется запятая. Символ, который будет выведен на печать в качестве разделителя разрядов, также определяется системными настройками.
Синтаксис: ##Параметр|NumberFormat:{0:0,0}##
Пример записи |
Результат вывода ДП типа "Число"со значением 456789 |
---|---|
##ExtParam123|NumberFormat:{0:0,0}## |
456 789 |
Общий пример
Перечисленные выше возможности форматирования можно использовать и вместе:
Пример записи |
Результат вывода ДП типа "Число"со значением 123456,78 |
---|---|
##ExtParam123|NumberFormat:{0:0,0.00}## или ##ExtParam123|NumberFormat:{0:\#,0.\#\#}## |
123 456,78 |
Деньги
Параметры типа "Деньги" имеют дополнительный модификатор MoneyToString для вывода сумму прописью.
Синтаксис записи для вывода прописи на русском: ##<Параметр>|MoneyToString:<RUR/USD/EUR/Number>##.
Синтаксис записи для вывода прописи на английском: ##<Параметр>|MoneyToString:<RUR,ENG/USD,ENG/EUR,ENG/Number,ENG>##.
Модификатор MoneyToString:Number выведет сумму прописью без указания валюты.
Пример записи |
Результат вывода ДП типа "Деньги"со значением 30 000 руб. |
---|---|
##ExtParam1516|MoneyToString:RUR## |
Тридцать тысяч рублей 00 копеек |
Модификатор MULTIPLY автоматически умножает сумму на указанный множитель (удобно, например, для расчета НДС).
Синтаксис записи: ##<Параметр>|MULTIPLY:<число>##.
Пример записи (расчет НДС 18%) |
Результат вывода ДП типа "Деньги"со значением 30 000 руб. |
---|---|
##ExtParam1516|MULTIPLY:0,18## |
5 400,00 |
Инструкцию по возможным значениям формата чисел можно получить на сайте MSDN.