LSCurrencyFormat
Description
Formats a number in a locale-specific currency format. To manage euro currency values, use the LSEuroCurrencyFormat function.
Return value
A formatted currency value.
Category
Display and formatting functions, International functions
Syntax
LSCurrencyFormat(number [, type ])
See also
LSEuroCurrencyFormat, SetLocale
History
New in ColdFusion MX: 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.
Currency output
The following table shows sample currency output:
| Locale |
Type = Local |
Type = International |
Type = None |
Dutch (Belgian)
|
100.000,00 BF
|
BEF100.000,00
|
100.000,00
|
Dutch (Standard)
|
fl 100.000,00
|
NLG100.000,00
|
100.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 FB
|
BEF100.000,00
|
100.000,00
|
French (Canadian)
|
100 000,00 $
|
CAD100 000,00
|
100 000,00
|
French (Standard)
|
100 000,00 F
|
FRF100 000,00
|
100 000,00
|
French (Swiss)
|
SFr. 100'000.00
|
CHF100'000.00
|
100'000.00
|
German (Austrian)
|
öS 100.000,00
|
ATS100.000,00
|
100.000,00
|
German (Standard)
|
100.000,00 DM
|
DEM100.000,00
|
100.000,00
|
German (Swiss)
|
SFr. 100'000.00
|
CHF100'000.00
|
100'000.00
|
Italian (Standard)
|
L. 10.000.000
|
ITL10.000.000
|
10.000.000
|
Italian (Swiss)
|
SFr. 100'000.00
|
CHF100'000.00
|
100'000.00
|
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)
|
R$100.000,00
|
BRC100.000,00
|
100.000,00
|
Spanish (Mexican)
|
$100,000.00
|
MXN100,000.00
|
100,000.00
|
Spanish (Modern)
|
10.000.000 Pts
|
ESP10.000.000
|
10.000.000
|
Spanish (Standard)
|
10.000.000 Pts
|
ESP10.000.000
|
10.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>
Comments
