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
|
|
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 |
|
|
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.
|
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 |
Chinese (Taiwan) |
NT$100,000.00 |
TWD100,000.00 |
100,000.00 |
Dutch (Belgian) |
100.000,00 Ä |
BEF100.000,00 |
100.000,00 |
|
100.000,00 BF |
EUR100.000,00 |
|
Dutch (Standard) |
Ä 100.000,00 |
NLG100.000,00 |
100.000,00 |
|
fl 100.000,00 |
EUR100.000,00 |
|
English (Australian) |
$100,000.00 |
AUD100,000.00 |
100,000.00 |
English (Canadian) |
$100,000.00 |
CAD100,000.00 |
100,000.00 |
English (New Zealand) |
$100,000.00 |
NZD100,000.00 |
100,000.00 |
English (UK) |
£100,000.00 |
GBP100,000.00 |
100,000.00 |
English (US) |
$100,000.00 |
USD100,000.00 |
100,000.00 |
French (Belgian) |
100.000,00 Ä |
EUR100.000,00 |
100.000,00 |
|
100.000,00 FB |
BEF100.000,00 |
|
French (Canadian) |
100 000,00 $ |
CAD100 000,00 |
100 000,00 |
French (Standard) |
100 000,00 Ä |
EUR100 000,00 |
100 000,00 |
|
100 000,00 F |
FRF100 000,00 |
|
French (Swiss) |
SFr.100'000.00 |
CHF100'000.00 |
100'000.00 |
German (Austrian) |
Ä 100.000,00 |
EUR100.000,00 |
100.000,00 |
|
öS 100.000,00 |
ATS100.000,00 |
|
German (Standard) |
100.000,00 Ä |
EUR100.000,00 |
100.000,00 |
|
100.000,00 DM |
DEM100.000,00 |
|
German (Swiss) |
SFr.100'000.00 |
CHF100'000.00 |
100'000.00 |
Italian (Standard) |
Ä 100.000,00 |
EUR10.000.000 |
10.000.000 |
|
L. 10.000.000 |
ITL10.000.000 |
|
Italian (Swiss) |
SFr. 100'000.00 |
CHF100'000.00 |
100'000.00 |
Japanese |
¥100,000 |
JPY100,000 |
JPY100,000 |
Korean |
W100,000 |
KRW100,000 |
100,000 |
Norwegian (Bokmal) |
kr 100 000,00 |
NOK100 000,00 |
100 000,00 |
Norwegian (Nynorsk) |
kr 100 000,00 |
NOK100 000,00 |
100 000,00 |
Portuguese (Brazilian) |
R$100.000,00 |
BRC100.000,00 |
100.000,00 |
Portuguese (Standard) |
100.000,00 Ä |
EUR100.000,00 |
100.000,00 |
|
R$100.000,00 |
BRC100.000,00 |
|
Spanish (Mexican) |
$100,000.00 |
MXN100,000.00 |
100,000.00 |
Spanish (Modern) |
100.000,00 Ä |
EUR10.000.000 |
10.000.000 |
|
10.000.000 Pts |
ESP10.000.000 |
|
Spanish (Standard) |
100.000,00 Ä |
ESP10.000.000 |
10.000.000 |
|
10.000.000 Pts |
EUR10.000.000 |
|
Swedish |
100.000,00 kr |
SEK100.000,00 |
100.000,00 |
|
Note: |
ColdFusion maps Spanish (Modern) to the Spanish (Standard) format. |
|
To set the default display format of date, time, number, and currency values, use the SetLocale function.
|
|
Example<h3>LSCurrencyFormat Example</h3>
<p>LSCurrencyFormat returns a currency value using the locale
convention. Default value is "local."
<!--- loop through list of locales; show currency values for 100,000 units --->
<cfloop LIST = "#Server.Coldfusion.SupportedLocales#"
index = "locale" delimiters = ",">
<cfset oldlocale = SetLocale(locale)>
<cfoutput><p><b><I>#locale#</I></b><br>
Local: #LSCurrencyFormat(100000, "local")#<br>
International: #LSCurrencyFormat(100000, "international")#<br>
None: #LSCurrencyFormat(100000, "none")#<br>
<hr noshade>
</cfoutput>
</cfloop>
|