User Guide
LSCurrencyFormat 597
LSCurrencyFormat
Description
Formats a number in a locale-specific currency format. For countries that use the euro, the result
depends on the JVM.
Returns
A formatted currency value.
Category
Display and formatting functions, International functions
Function syntax
LSCurrencyFormat(number [, type ])
See also
LSEuroCurrencyFormat, LSIsCurrency, LSParseCurrency, LSParseEuroCurrency,
SetLocale
History
ColdFusion MX: Changed formatting behavior: this function might return different formatting
than in earlier releases. If a negative number is passed to it, it returns a negative number. If
type =
"local"
, it returns the value in the current locale’s standard format. If type =
"international"
, it returns the value in the current locale’s international standard format. This
function uses Java standard locale formatting rules on all platforms.
Parameters
Usage
This function uses Java standard locale formatting rules on all platforms.
Note: With a Sun 1.3.1-compliant JVM, use the LSEuroCurrencyFormat function to format euro
currency values.
Currency output
The following table shows sample currency output. For locales that use Euro, the Local and
International columns contains two entries. The first is entry is the result with a Sun the 1.4.1-
compliant JVM, the second entry is the result with a 1.3.1-compliant JVM.
Parameter Description
number Currency value
type • local: the currency format and currency symbol used in the locale.
- With JDK 1.3, the default for Euro Zone countries is their local currency.
- With JDK 1.4, the default for Euro Zone countries is the euro.
• international: the international standard currency format and currency symbol of the
locale.
• none: the currency format used in the locale; no currency symbol
Locale Type = Local Type = International Type = None
Chinese (China) ¥100,000.00 CNY100,000.00 100,000.00
Chinese (Hong Kong) HK$100,000.00 HKD100,000.00 100,000.00