Macromedia coldfusion 4.5-cfml language reference User Manual
450
CFML Language Reference
LSNumberFormat
Formats a number using the locale convention. If mask is omitted, the number is
formatted as an integer.
formatted as an integer.
Syntax
LSNumberFormat(
number [, mask ])
number
The number you want to format.
mask
All LSNumberFormat mask characters apply except that ($) dollar, (,) comma, and
(.) dot are mapped to their locale-specific counterparts.
(.) dot are mapped to their locale-specific counterparts.
Note
If you do not specify a sign for the mask, positive and negative numbers
will not align in columns. As a result, if you expect to display both positive
will not align in columns. As a result, if you expect to display both positive
LSNumberFormat Mask Characters
Character
Meaning
_ (underscore)
Optional digit placeholder.
9
Optional digit placeholder. Same as _, but shows decimal places
more clearly.
more clearly.
.
Specifies the location of a mandatory decimal point.
0
Located to the left or right of a mandatory decimal point, to
force padding with zeros.
force padding with zeros.
( )
Places parentheses around the mask if the number is less than 0.
+
Places + in front of positive numbers, - (minus sign) in front of
negative numbers.
negative numbers.
-
Place " " (space) in front of positive, - (minus sign) in front of
negative numbers.
negative numbers.
,
Separates thousands with commas.
L,C
Specifies left-justify or center-justify a number within the width
of the mask column. L or C must appear as the first character of
the mask. By default, numbers are right-justified.
of the mask column. L or C must appear as the first character of
the mask. By default, numbers are right-justified.
$
Places a dollar sign in front of the formatted number. $ must
appear as the first character of the mask.
appear as the first character of the mask.
^
Separates left from right formatting.