説明
ロケール固有の通貨形式を使用して、数値を形式設定します。
戻り値
形式設定した通貨の値。ユーロ通貨圏に属する国の場合は、通貨をユーロで形式設定するためのロケールの規則が使用されます。
カテゴリ
シンタックス
LSEuroCurrencyFormat(currency [, type, locale])
関連項目
LSParseEuroCurrency、LSCurrencyFormat、SetLocale、『ColdFusion アプリケーションの開発』の ロケールに特有のコンテンツ
ColdFusion では、Spanish (Modern) と Spanish (Standard) に対して Spanish (Standard) 形式が使用されます。
履歴
- ColdFusion（2018 リリース）：パラメーター名 currency-number が currency に変更されました。
- ColdFusion 8：locale パラメーターが追加されました。
- ColdFusion MX：形式設定の動作が変更されました。この関数では、以前のリリースと異なる形式で結果が返される場合があります。この関数では、すべてのプラットフォームで Java 標準のロケール形式設定ルールが使用されます。ただし、ユーロ通貨圏に属する国の場合は、使用方法のセクションに解説した規則が使用されます。したがって、ユーロ圏に属さないロケールでは、ユーロではなくその国の通貨を用いて形式設定されます。
パラメーター
パラメーター |
説明 |
|---|---|
currency |
通貨値です。 |
locale |
関数を処理するときに、ページのロケールの代わりに使用するロケールです |
type |
|
使用方法
この関数では、すべてのバージョンの JVM で、ユーロ通貨の形式設定ルールが次のように使用されます。
- 現在のロケールの国がユーロ圏に属する場合（ユーロに移行済みの参加国である場合）は、type に local を指定して形式設定した出力にはユーロ通貨記号が含まれます。また、type に international を指定して形式設定した出力には、ユーロ通貨を表す略号（EUR）が含まれます。値が負の場合、現在のロケールの形式設定ルールに従って、値の前に負の符号が付くか、値が括弧で囲まれます。
- 現在のロケールの国がユーロ圏ではない場合、現在のロケールの通貨記号または略号が表示されます。値が負の場合、現在のロケールの形式設定ルールに従って、値の前に負の符号が付くか、値が括弧で囲まれます。ColdFusion がサポートするロケールオプションの一覧や、日付、時刻、数値および通貨のデフォルトの表示形式の設定に関する情報について詳しくは、SetLocale を参照してください。
通貨の出力
次の表に、通貨出力の例を示します。
ロケール |
Type = Local |
Type = International |
Type = None |
|---|---|---|---|
Chinese (China mainland) |
100,000.00 |
CNY100,000.00 |
100,000.00 |
Chinese (Hong Kong SAR of China) |
HK$100,000.00 |
HKD100,000.00 |
100,000.00 |
Chinese (Taiwan region) |
NT$100,000.00 |
TWD100,000.00 |
100,000.00 |
Dutch (Belgian) |
100.000,00 |
EUR100.000,00 |
100.000,00 |
Dutch (Standard) |
100.000,00 |
EUR100.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 |
EUR100.000,00 |
100.000,00 |
French (Canadian) |
100 000,00 $ |
CAD100 000,00 |
100 000,00 |
French (Standard) |
100 000,00 |
EUR100 000,00 |
100 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 |
German (Standard) |
100.000,00 |
EUR100.000,00 |
100.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 |
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 |
Spanish (Mexican) |
$100,000.00 |
MXN100,000.00 |
100,000.00 |
Spanish (Modern) |
100.000,00 |
EUR10.000.000 |
10.000.000 |
Spanish (Standard) |
100.000,00 |
ESP10.000.000 |
10.000.000 |
Swedish |
100.000,00 kr |
SEK100.000,00 |
100.000,00 |
次の例は、この関数で負の数を形式設定した場合の動作を示しています。負の数は、現在のロケールの形式設定ルールに従って、値の前に負の符号が付くか、値が括弧で囲まれる形式となります。
入力値 |
ロケールが French (Standard) の場合の出力 |
ロケールが English (US) の場合の出力 |
-1234.56 |
-1 234,56 |
($1,234.56) |
例
<h3>LSEuroCurrencyFormat の例</h3> <p>LSEuroCurrencyFormat はロケール変換を使用して通貨の値を返します。デフォルト値は「local」です。<! ---ロケールのリストを表示、100,000 単位で通貨の値を表示---> <cfloop list = "#Server.Coldfusion.SupportedLocales#" index = "locale" delimiters = ","> <cfset oldlocale = SetLocale(locale)> <cfoutput><p><B><I>#locale#</I></B><br> Local: #LSEuroCurrencyFormat(100000, "local")#<br> International: #LSEuroCurrencyFormat(100000, "international")#<br> None: #LSEuroCurrencyFormat(100000, "none")#<br> <Hr noshade> </cfoutput> </cfloop>
