SETLOCALE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
説明
国/言語ロケールを設定します。このロケールは、ColdFusion の処理と、クライアントに返されるページに適用されます。言語および地域の表記規則に従って、日付、時刻、数値、および通貨値のデフォルト表示形式がロケール値によって決定されます。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
戻り値
ロケールを設定する前に設定されていたロケール値を表す文字列 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
カテゴリ
各国語対応関数、システム関数 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
関数のシンタックスSetLocale(new_locale) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
関連項目
GetHttpTimeString、GetLocale、GetLocaleDisplayName、『ColdFusion MX 開発ガイド』の第17章の「グローバル化アプリケーションの開発」 の「ロケール」 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ヒストリ
ColdFusion MX 7: ColdFusion MX Java ランタイムがサポートするすべてのロケールに対応できるようになりました。 ColdFusion MX:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
パラメータ
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
使用方法
Server.Coldfusion.SupportedLocales 変数にリストされている任意のロケール名を指定できます。この変数は、JVM がサポートするすべてのロケール名、および ColdFusion MX 7 より前の ColdFusion MX で必要であったロケール名のカンマ区切りリストです。 次のロケール名は、ColdFusion MX 6.1 までの ColdFusion リリースで使用され、継続してサポートされます。これらの値のいずれかを SetLocale 関数で使用する場合は、対応する Java ロケール名ではなくユーザーが設定した名前を GetLocale 関数が返します。
ColdFusion では、ロケールの値を次のように決定します。
この関数は変更前のロケール設定を戻り値として返します。これを使えば、元のロケール値を保存しておくことができます。元のロケールに戻すには、保存しておいた変数を使って SetLocale 関数を再度呼び出します。たとえば次のコードでは、元のロケールを Session 変数に保存しています。 <cfset Session.oldlocale = SetLocale(newLocale)> server.ColdFusion.SupportedLocales 変数は起動時に初期化され、ColdFusion およびオペレーティングシステムがサポートするロケールの一覧がカンマ区切りリストが格納されます。このリストに含まれないロケールを指定して SetLocale を呼び出すと、エラーが発生します。
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
例<h3>SetLocale の例</h3> <p>SetLocale は、指定されたロケールを、現在のセッションで使用する新しいロケールとして設定します。 <p>ロケールとは、日付、時刻、数値、および通貨値の表示と形式設定を制御する一連の属性をカプセル化したもの です。 <p>このシステムのロケール : <cfoutput>#GetLocale()#</cfoutput> <p><cfoutput><I>変更前のロケール : #SetLocale("English (UK)")#</I> <p>現在のロケール : #GetLocale()#</cfoutput> |
NEW_LOCALE | |
ロケール名です。例 : "English (US)" |