numberFormat

Создает числовое значение с пользовательским форматом. Для международного форматирования чисел используйте LSNumberFormat.Маска состоит из следующих символов:_,9 Заполнитель цифры; . десятичная точка; 0 дополняет нулями;( ) если число меньше нуля, заключает маску в скобки;+ знак плюс перед положительным числом, знак минус перед отрицательным- пробел перед положительным числом, знак минус перед отрицательным, разделяет каждую третью десятичную разрядность запятой.L,C выравнивает число по левому краю или по центру.$ знак доллара перед отформатированным числом.^ разделяет форматирование слева и справа.

numberFormat(number [, mask]) → returns string

Lucee

BL 1.0.0+

Справочник по аргументам

number числовой
Обязательный

mask строка

_ : (подчеркивание): необязательный заполнитель цифры.9 : необязательный заполнитель цифры. (Отображает десятичные разряды нагляднее, чем _.) Обратите внимание: если после десятичной точки используется ‘9’ или ‘_’, при необходимости значение будет дополнено нулями. . : Расположение обязательной десятичной точки.0 : Располагается слева или справа от обязательной десятичной точки. Дополняет нулями.( ) : Если число меньше нуля, заключает маску в скобки.+ : Ставит знак плюса перед положительным числом и знак минуса перед отрицательным числом.- : Ставит пробел перед положительным числом и знак минуса перед отрицательным числом., : Разделяет каждую третью десятичную разрядность запятой.L,C : Выравнивает число по левому краю или по центру в пределах ширины столбца маски. Первый символ маски должен быть L или C. По умолчанию используется выравнивание по правому краю.$ : Ставит знак доллара перед отформатированным числом. Первым символом маски должен быть знак доллара ($).^ : Разделяет форматирование слева и справа.

Ссылки дополнительная информация о numberFormat

Исследование функции ColdFusion NumberFormat() — автор Ben Nadel, 13 августа 2007 г.

Примеры
Примеры вызова функции numberFormat

Форматирование с двумя десятичными знаками

<cfoutput>1.234 ('__.00') -> #numberFormat(1.234,'__.00')#<br/> <!--- 1.23 --->
1234 ('__.00') -> #numberFormat(1234,'__.00')#<br/> <!--- 1234.00 ---></cfoutput>

Маска 0 и 9

<cfoutput>
123 ('00000') -> #numberFormat(123,'00000')#<br/>
123 ('99999') -> #numberFormat(123,'99999')#<br/>
123 ('99.99999') -> #numberFormat(123.12,'99.99999')#<br/>
</cfoutput>

Маска _

<cfoutput>
123 ('_____') -> #numberFormat(123,'_____')#<br/>
123 ('_.___') -> #numberFormat(123,'_.___')#<br/>
11.10 ('__.000') -> #numberFormat(11.10,'__.000')#<br/>
</cfoutput>

Маска + и -

<cfoutput>
123 ('+') -> #numberFormat(123,'+')#<br/>
-123 ('-') -> #numberFormat(-123,'-')#<br/>
</cfoutput>

Запятая ,

<cfoutput>
123 (',') -> #numberFormat(123,',')#<br/>
123456 (',') -> #numberFormat(123456,',')#<br/>
</cfoutput>

Маска L,C

<cfoutput>
1 ("L999") -> #NumberFormat( 1, "L999" )#<br/>
1 ("C000") -> #NumberFormat( 1, "C000" )#<br/>
</cfoutput>

Два десятичных знака, десятичное число на входе

numberFormat(1.23,'__.00')

Ожидаемый результат: 1.23

Два десятичных знака, целое число на входе

numberFormat(123,'__.00')

Ожидаемый результат: 123.00

Ноль дополняет нулями, девятка — нет

num1 = NumberFormat(123,'00000');
num2 = NumberFormat(123,'99999');
    
writeOutput(num1&'/'&num2);

Ожидаемый результат: 00123/ 123

Отображение знака положительного/отрицательного числа

num1 = NumberFormat( 5, "+" );
num2 = NumberFormat( -5, "+" );
    
writeOutput(num1&'/'&num2);

Ожидаемый результат: +5/-5

Форматирование в долларах США

Вместо этого можно использовать dollarFormat() или lsCurrencyFormat()

numberFormat(123456789,'_$,9.99')

Ожидаемый результат: $123,456,789.00

© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/numberformat