日付および時刻フォーマットを選択するには、事前定義のパターンを使用する方法とカスタムパターンを使用する方法の 2 種類の方法があります。 ほとんどの用途で、DateTimeStyle 定数(
例えば、次のコードにより、デフォルトの短い日付フォーマットを使用して、日付文字列が作成されます。
このクラスのインスタンスが作成されると、要求されたロケールがオペレーティングシステムでサポートされている場合、要求されたロケールおよびコンストラクターの
このクラスには、月の名前および曜日の名前のローカライズされた文字列を取得し、カレンダーピッカーやその他の同様のアプリケーションで使用できる週の最初の日を取得する追加のメソッドが含まれています。
ユーザー設定の使用、オペレーティングシステムによって提供されるフォーマットパターンの使用および要求したロケールがサポートされてない場合の代替ロケールの使用が原因となり、同じロケール ID を使用していても、ユーザーによって表示されるフォーマット結果が異なる場合があります。
この例では、英語(米国)、フランス語(フランス)、スペイン語(スペイン)のロケールを使用しています。
この例では、リストの各ロケールに対して、次の処理を行います。
この例では、リストの各ロケールに対して、次の処理を行います。
このコンストラクターは、現在のオペレーティングシステムが要求されたロケール ID 名をサポートしているかどうかを判別します。サポートされていない場合、代わりに代替のロケールが使用されます。代替のロケール ID の名前は、
ユーザーの現在のオペレーティングシステムの環境設定に基づいてフォーマットするには、
コンストラクターが呼び出されて正しく完了すると、
要求されたロケール ID 名を使用できない場合、
それ以外の場合、
上記の警告および
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このクラスが現在のオペレーティングシステムでサポートされていない場合、このメソッドは null 値を返します。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
有効な値:
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このパターンは次の 3 つの方法のいずれかで設定できます。
パターンシンタックスについて詳しくは、「
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
有効な値:
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
日付をフォーマットするために使用されるパターンは次の 3 つの方法のいずれかで設定できます。
このメソッドの副作用として、この DateTimeFormatter オブジェクトの現在の時間および日付スタイルが無効になり、値
パターンストリングにより、日付と時間をフォーマットする方法が定義されます。パターンには、フォーマットされたストリングで日付および時間の値に置き換えられる文字シーケンスが含まれます。例えば、「yyyy/MM」というパターンでは、「yyyy」という文字列が 4 桁の年に置き換えられ、その後に「/」が続き、「MM」という文字列が 2 桁の月に置き換えられます。
パターンで使用される文字の多くは、以下の表に示したように、2 回以上繰り返し使用して、様々な出力を生み出すことができます。
シーケンスがパターンでサポートされている文字の最大数を超えると、そのパターン文字でサポートされている最も長いシーケンスに戻って割り当てられます。次に実際の使用例を示します。
理論的には、パターンには最大 255 文字まで含むことができますが、さらに制限の厳しいプラットフォームもあります。パターンがパターン文字数制限を超えると、
各オペレーティングシステムで有効なパターンがすべてサポートされているわけではありません。パターンがプラットフォームでサポートされていない場合、代替パターンが使用され、代替パターンが使用されていることを示すように
次の表は有効なパターン文字とその意味を示しています。
次のように解釈される紀元のパターンには 1~5 文字を含むことができます。
グレゴリオ暦の例(このパターンをサポートするオペレーティングシステム):
例:
例:
例:
例:
例(このパターンをサポートするオペレーティングシステムの場合):
年間第 2 週の例(このパターンをサポートするオペレーティングシステムの場合):
7 月第 2 週の例(このパターンをサポートするオペレーティングシステムの場合):
年間 2 日目の例(このパターンをサポートするオペレーティングシステムの場合):
7 月第 2 水曜日の例(このパターンをサポートするオペレーティングシステムの場合):
例:
例:
例:
例(このパターンをサポートするオペレーティングシステムの場合):
例(このパターンをサポートするオペレーティングシステムの場合):
例:
例:
例:
このタイムゾーンのパターンでは 1~4 文字を使用し、次のように解釈されます。
この形式をサポートするオペレーティングシステムの例:
このタイムゾーンのパターンでは 1~4 文字を使用し、次のように解釈されます。
この形式をサポートするオペレーティングシステムの例:
このタイムゾーンのパターンでは 1~4 文字を使用し、次のように解釈されます。
この形式をサポートするオペレーティングシステムの例:
例:
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
オペレーティングシステムおよび
次に実際の使用例を示します。
var fmt:DateTimeFormatter = new DateTimeFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; 上の例では、
aliName はユーザーの現在のオペレーティングシステムの設定に対応するロケールの名前(例えば、ユーザーのロケールが「イタリア語 - イタリア」に設定されている場合、「it-IT」)になり、「i-default 」(LocaleID.DEFAULT ロケールの名前)にはなりません。
次に例を示します。
var fmt:DateTimeFormatter = new DateTimeFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; 上の例のオペレーティングシステムが「fr-CA」(フランス語 - カナダ)ロケール ID をサポートしていないと仮定すれば、代替のロケール ID が使用されます。この場合、代替ロケール ID は「fr-FR」(フランス語 - フランス)です。
例えば、次のコードは
次の例は、
例えば、次のコードは無効な「xx」パターンの後に
例えば、不完全な文字列の後に
数値のストリングには、数字を囲む接頭辞と接尾辞を含めることができます。この場合、
この例では、アラビア語(サウジアラビア)、英語(米国)、英語(米国、POSIX バリアント)、中国語(中華人民共和国)、中国語(台湾)、中国語(簡体字)、中国語(中華人民共和国と複数のキーおよび値)のロケールを使用します。
この例では、リストの各ロケールに対して、次の処理を行います。
コンストラクターが正しく完了すると、
要求されたロケール ID 名を使用できない場合、
それ以外の場合、
上記の警告および
結果のリストは、優先順序に従ってソートされています。
このメソッドを使用する典型的な場合は以下のとおりです。
この機能が現在のオペレーティングシステムでサポートされていない場合、このメソッドは null 値を返します。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
返されるオブジェクトは HashTable または結合配列として構築され、そこでは、プロパティ名がキーを表し、プロパティの値がそのキーの値を表します。例えば、次のコードは LocaleID オブジェクトから
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
ロケール名を正しく解析できない場合、言語コードは省略形でないロケール名と同じになります。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドは、地域コードを解析または推定できない場合、空白の文字列を返します。これは、「xy」などの不明または不完全なロケール ID 名が使用される場合に起きる可能性があります。 地域コードは固定リストに照らして検証されません。例えば、「xx-YY」のロケール ID 名に対して返される地域コードは、「YY」になります。
このメソッドが呼び出されて正しく完了すると、
地域が指定されたロケール名の一部でない場合、そのロケールに対して最も可能性のある地域コードが「推定」され、
それ以外の場合、
このメソッドは、スクリプトコードを解析または推定できない場合、空白の文字列を返します。これは、「xy」などの不明または不完全なロケール ID 名が使用される場合に起きる可能性があります。 スクリプトコードは固定リストに照らして検証されません。例えば、「xx-Abcd-YY」のロケール ID 名に対して返されるスクリプトコードは「Abcd」です。
地域および言語も、戻り値に影響する可能性があります。例えば、「mn-MN」(モンゴル語-モンゴル)のスクリプトコードは「Cyrl」(キリル文字)で、「mn-CN」(モンゴル語-中国)のスクリプトコードは「Mong」(モンゴル語)です。
このメソッドが呼び出されて正しく完了すると、
スクリプトコードが指定されたロケール名の一部でない場合、最も可能性のあるスクリプトコードが「推定」され、
それ以外の場合、
所定のロケール ID 名に言語バリアントコードがない場合、このメソッドは空白の文字列を返します。 (言語バリアントがあるロケールまたはそれを必要とするロケールはほとんどないので、推定は不要です。)
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
この結果を使用して、Flash テキストエンジン内でテキストの向きを決め、ユーザーインターフェイスをミラーして現在のテキストの向きをサポートするかどうかを決めることができます。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このロケール識別子は必ずしも最も使用に適したものとは限りません。ブラウザーで動作しているアプリケーションの場合、ブラウザーの優先ロケールがより適切な選択になる可能性があります。多くの場合、ユーザーに優先ロケール ID 名を変更させ、その環境設定をユーザープロファイル、cookie、または共有オブジェクトに保存させることをお勧めします。
このメソッドは、次のロケール ID 名への変換を実行して、このロケール ID 名に、より規範的なフォームを付与します。
これ以外に実行される処理はありません。例えば、エイリアスの置換および要素の追加や削除はありません。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
場合により、大文字と小文字の変換は 1 つの文字からもう 1 つの文字への単純な変換ではなく、言語またはコンテキスト固有の処理が必要になる場合があります。次に実際の使用例を示します。
このクラスの
ユーザー設定の使用、オペレーティングシステムによって提供される大文字と小文字の変換ルールの使用および要求したロケールがサポートされていない場合の代替ロケールの使用が原因となり、同じロケール ID を使用していても、ユーザーによってさまざまな大文字と小文字の変換結果が表示される場合があります。
この例では、次の手順が実行されます。
このコンストラクターは、現在のオペレーティングシステムが要求されたロケール ID 名をサポートしているかどうかを判別します。サポートされていない場合、代わりに代替のロケールが使用されます。代替のロケールが使用される場合、
このコンストラクターが正しく完了すると、
要求されたロケール ID 名を使用できない場合、
それ以外の場合、
このクラスが現在のオペレーティングシステムでサポートされていない場合、このメソッドは null 値を返します。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
オペレーティングシステムおよび
次に実際の使用例を示します。
var tools:StringTools = new StringTools(LocaleID.DEFAULT); var aliName:String = tools.actualLocaleIDName; 上の例では、
aliName はユーザーの現在のオペレーティングシステムの設定に対応するロケールの名前(例えば、ユーザーのロケールが「イタリア語 - イタリア」に設定されている場合、「it-IT」)になり、「i-default 」(LocaleID.DEFAULT ロケールの名前)にはなりません。
次に例を示します。
var tools:StringTools = new StringTools("fr-CA"); var aliName:String = tools.actualLocaleIDName; 上の例のオペレーティングシステムが「fr-CA」(フランス語 - カナダ)ロケール ID をサポートしていないと仮定すれば、代替のロケール ID が使用されます。この場合、代替ロケール ID は「fr-FR」(フランス語 - フランス)です。
NumberFormatter クラスはオペレーティングシステムで提供されるデータおよび機能を使用し、特定のロケールの規則に従い、ユーザーの環境設定とユーザーのオペレーティングシステムによってサポートされている機能に基づいて、数字をフォーマットするように設計されています。マイナス記号、小数点の記号、グループ化の区切り文字、グループ化パターンおよび数字フォーマット内のその他の要素はロケールによって異なる場合があります。
要求されたロケールをオペレーティングシステムがサポートする場合、数値フォーマットプロパティは、要求されたロケールの規則とデフォルトに従って設定されます。要求されたロケールを使用できない場合、プロパティは
ユーザーの設定を使用し、オペレーティングシステムによって提供されるフォーマットパターンを使用し、要求されたロケールを使用できないときに代替のロケールを使用するせいで、同じロケール ID を使用していても、ユーザーによって表示されるフォーマット結果が異なる場合があります。
この例では、ユーザーのオペレーティングシステムのデフォルトのロケールである、日本語(日本)、英語(米国)およびフランス語(フランス)の各ロケールを使用して数字をフォーマットします。この例では、静的メンバー
この例の結果は、オペレーティングシステムやユーザー環境設定によって異なる場合があります。
この例では、リストの各ロケールに対して、次の処理を行います。
この例の結果は、オペレーティングシステムやユーザー環境設定によって異なる場合があります。
この例では、次の処理を行います。
このコンストラクターは、現在のオペレーティングシステムが要求されたロケール ID 名をサポートしているかどうかを判別します。サポートされていない場合、代わりに代替のロケールが使用されます。代替のロケールが使用される場合、
ユーザーの現在のオペレーティングシステムの環境設定に基づいてフォーマットするには、
コンストラクターが正しく完了すると、
要求されたロケール ID 名を使用できない場合、
このクラスが現在のオペレーティングシステムでサポートされていない場合、
それ以外の場合、
上記の警告および
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
この関数はフォーマッターのプロパティ値に基づいて数字をフォーマットします。numberFormatter オブジェクトの作成後にプロパティが変更されない場合、数字は、actualLocaleIDName によって識別されるロケールのオペレーティングシステムが提供するロケール固有の規則に従ってフォーマットされます。フォーマットをカスタマイズするために、プロパティを変更して、特定の面で数字のフォーマットを変更できます。
非常に大きな数字と非常に小さな数字をこの関数でフォーマットできます。ただし、有効桁数は Number オブジェクトによって指定される精度に限定されます。科学的記数法はサポートされていません。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このクラスが現在のオペレーティングシステムでサポートされていない場合、このメソッドは null 値を返します。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
数字桁の前または後ろにプラス記号「+」が付いている場合は、空白文字以外として扱われます。戻り値は
数字の解析および有効な数字の構成について詳しくは、解析機能の説明を参照してください。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
NumberParseResult オブジェクトには入力文字列で見つかった最初の数字の値、文字列内の数字の開始索引、文字列内の数字の後の最初の文字の索引が含まれます。
ストリングに数字が含まれない場合、NumberParseResult の value プロパティは
この関数は、
次の表はさまざまな NegativeNumberFormat 値で解析される文字列の結果を示しています。
数字とマイナス記号または括弧の間には、スペースを 1 つ入れることができます。
その他のプロパティは、有効な数字を判別するときに無視されます。特に
数字の前または後にプラス記号「+」が付いている場合、このプラス記号は数字の一部ではない文字として扱われます。
この関数では、科学的表記の数字(1.23e40 など)が含まれるストリングは解析されません。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
オペレーティングシステムおよび
次に実際の使用例を示します。
var fmt:NumberFormatter = new NumberFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; 上の例では、
aliName はユーザーの現在のオペレーティングシステムの設定に対応するロケールの名前(例えば、ユーザーのロケールが「イタリア語 - イタリア」に設定されている場合、「it-IT」)になり、「i-default 」(LocaleID.DEFAULT ロケールの名前)にはなりません。
次に例を示します。
var fmt:NumberFormatter = new NumberFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; 上の例のオペレーティングシステムが「fr-CA」(フランス語 - カナダ)ロケール ID をサポートしていないと仮定すれば、代替のロケール ID が使用されます。この場合、代替ロケール ID は「fr-FR」(フランス語 - フランス)です。
このプロパティは最初、formatter オブジェクトを構築するときに選択したロケールに基づいて設定されます。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
さまざまな言語と地域で使用されるさまざまな文字セットを、0~9 の数字で表します。 このプロパティは、使用される数字のセットを定義します。
このプロパティの値は、10 進数字セットのゼロ桁の Unicode 値を表しています。このプロパティの有効な値は NationalDigitsType クラスで定義されています。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
数字はこのプロパティによって指定された桁数に丸められます。丸めのスキームは、ユーザーのオペレーティングシステムによって異なります。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
グループ化パターンはセミコロンで区切られ、場合によっては最後にアスタリスクが付く数字を含む文字列として定義されます。例:
文字列内の最初の数字は、小数点の左側の数字の最初のグループに対応しています。その後に続く数字は、左側の後続のグループの桁数を定義します。 このため、文字列「3;2;*」はグループ化区切り文字が最初の 3 桁のグループの後に置かれ、その後に 2 桁のグループが続くことを示しています。例:
次の表は、さまざまなグループ化パターンによる数字 123456789.12 のフォーマットの例を示しています。グループ化の区切り文字はカンマで、小数点はピリオドです。
限定された数のグループ化サイズのみ定義できます。一部のオペレーティングシステムは、グループ化パターンに 2 つの数字とアスタリスクのみ含むことができます。 その他のオペレーティングシステムは、4 つまでの数字とアスタリスクを含むことができます。アスタリスクがないパターンの場合、一部のオペレーティングシステムは 1 つの数字のみサポートし、その他のオペレーティングシステムは 3 つまでの数字をサポートします。グループ化パターン要素の最大数を超えると、追加の要素は無視され、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティが
例えば、数値が 0.321 でこのプロパティが
次の表は、このプロパティと
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
次の表は、負の数の有効なフォーマットの概要を示しています。負の数がフォーマットされると、フォーマットのマイナス記号が
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
この記号は、0 よりも小さい数値をフォーマットするときに、負の数値のフォーマットと組み合わせて使用されます。負の記号を含まない負の数値のフォーマットでは使用されません(例えば、負の数値が括弧で囲まれている場合)。
このプロパティは、このフォーマッターを構築するときに選択した実際のロケールのデフォルト値に設定されます。値を設定して、デフォルト設定を無効にすることができます。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティが
例えば、数値が 123.4 で、このプロパティが true に設定されている場合、
次の表は、このプロパティと
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
グループ化区切りとして使用される記号は
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
context パラメーターによってのみ、特定のロケールおよびオペレーティングシステムでこれらのメソッドの結果が変わります。ほとんどのロケールでは、月名と曜日名のリストがコンテキストによって変わることはありません。
CurrencyFormatter クラスはオペレーティングシステムで提供されるデータおよび機能を使用し、特定のロケールと通貨の種類の規則に従って通貨値をフォーマットするように設計されています。通貨記号、マイナス記号、小数点、グループ化区切り、グループ化パターン小数点およびその他の要素の位置は、ロケールによって変わります。
要求されたロケールをオペレーティングシステムがサポートする場合、プロパティと通貨の種類は、要求されたロケールの規則とデフォルトに従って設定されます。要求されたロケールを使用できない場合、プロパティは
ユーザーの設定を使用し、オペレーティングシステムによって提供されるフォーマットパターンを使用し、要求されたロケールを使用できないときに代替のロケールを使用するせいで、同じロケール ID を使用していても、ユーザーによって表示されるフォーマット結果が異なる場合があります。
この例では次のロケールを使用します。
この例では、リストの各ロケールに対して、次の処理を行います。
この例では、次の手順が実行されます。
このコンストラクターは、現在のオペレーティングシステムが要求されたロケール ID 名をサポートしているかどうかを判別します。サポートされていない場合、代わりに代替のロケールが使用されます。代替のロケールが使用される場合、
注意:代替のロケールが使用されると、通貨プロパティがデフォルトの値に設定されます。そのため、
ユーザーの現在のオペレーティングシステムの環境設定に基づいてフォーマットするには、
コンストラクターが呼び出されて正しく完了すると、
要求されたロケール ID 名を使用できない場合、
それ以外の場合、
上記の警告および
デフォルトでは、このメソッドは
多くの国や地域では、さまざまな通貨に同じ通貨記号を使用しています。例えば、米国、オーストラリア、ニュージーランド、カナダおよびメキシコはすべて、国内通貨の値に同じドル記号($)を使用しています。通貨のフォーマットがユーザーの地域の通貨と異なる場合は、ISO コードを通貨ストリングとして使用することをお勧めします。
このメソッドで、多数の非常に高額の通貨および非常に小額の通貨をフォーマットできます。 ただし、有効桁数は Number データ型によって指定される精度に限定されます。
2 番目の例は、デフォルトのユーザーのロケールを使用して、カナダドルで通貨額をフォーマットするメソッドを示しています。
多くの地域や国で、同じ通貨記号が使用されています。このメソッドを使用して、あいまいな通貨記号、または代替のロケールの使用によって予期されるものとは異なる通貨記号や ISO コードが使用されるのを防ぐことができます。
このメソッドがよく使用されるのは、ロケールの通貨記号を表示するか(金額がユーザーのデフォルトの通貨でフォーマットされる場合)、またはさらに固有の ISO コード文字列を表示するか(金額がユーザーのデフォルトとは異なる通貨でフォーマットされる場合)を決めるために使用する場合です。
このメソッドは
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このクラスが現在のオペレーティングシステムでサポートされていない場合、このメソッドは null 値を返します。
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
解析アルゴリズムは
入力ストリング内の通貨記号、負の記号および数字の順序が
入力ストリングには、解析中に無視される空白文字が含まれる場合があります。
通貨記号がない場合でも解析は成功します。文字列の通貨記号に該当する部分には検証は実行されませn。通貨記号またはストリングがない場合、返される CurrencyParseResult オブジェクト内の
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
オペレーティングシステムおよび
次に実際の使用例を示します。
var fmt:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; 上の例では、
aliName はユーザーの現在のオペレーティングシステムの設定に対応するロケールの名前(例えば、ユーザーのロケールが「イタリア語 - イタリア」に設定されている場合、「it-IT」)になり、「i-default 」(LocaleID.DEFAULT ロケールの名前)にはなりません。
次に例を示します。
var fmt:CurrencyFormatter = new CurrencyFormatter("fr-CA"); var aliName:String = fmt.actualLocaleIDName; 上の例のオペレーティングシステムが「fr-CA」(フランス語 - カナダ)ロケール ID をサポートしていないと仮定すれば、代替のロケール ID が使用されます。この場合、代替ロケール ID は「fr-FR」(フランス語 - フランス)です。
このコードは、
このプロパティは、使用される実際のロケールに基づいて、コンストラクターによって初期化されます。代替のロケールが使用される場合、このプロパティは、代替のロケールで優先されるデフォルトの通貨コードを反映します。
このプロパティは、
このプロパティは、使用される実際のロケールに基づいて、コンストラクターによって初期化されます。代替のロケールが使用される場合、このプロパティは、代替のロケールで優先されるデフォルトの通貨記号を反映します。
このプロパティは最初、formatter オブジェクトを構築するときに選択したロケールに基づいて設定されます。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
さまざまな言語と地域で使用されるさまざまな文字セットを、0~9 の数字で表します。 このプロパティは、使用される数字のセットを定義します。
このプロパティの値は、10 進数字セットのゼロ桁の Unicode 値を表しています。このプロパティの有効な値は NationalDigitsType クラスで定義されています。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
数字はこのプロパティによって指定された桁数に丸められます。丸めのスキームは、ユーザーのオペレーティングシステムによって異なります。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
グループ化パターンはセミコロンで区切られ、場合によっては最後にアスタリスクが付く数字を含む文字列として定義されます。例:
文字列内の最初の数字は、小数点の左側の数字の最初のグループに対応しています。その後に続く数字は、左側の後続のグループの桁数を定義します。 このため、文字列「3;2;*」はグループ化区切り文字が最初の 3 桁のグループの後に置かれ、その後に 2 桁のグループが続くことを示しています。例:
次の表は、さまざまなグループ化パターンによる通貨額 123456789.12 のフォーマットの例を示しています。グループ化区切りはカンマ、小数点はピリオド、ドル記号($)は通貨記号です。
限定された数のグループ化サイズのみ定義できます。一部のオペレーティングシステムは、グループ化パターンに 2 つの数字とアスタリスクのみ含むことができます。 その他のオペレーティングシステムは、4 つまでの数字とアスタリスクを含むことができます。アスタリスクがないパターンの場合、一部のオペレーティングシステムは 1 つの数字のみサポートし、その他のオペレーティングシステムは 3 つまでの数字をサポートします。グループ化パターン要素の最大数を超えると、追加の要素は無視され、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティが
例えば、金額が 0.321 でこのプロパティが
次の表は、このプロパティと
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティの値は、下の表で定義された定数のいずれかになります。
下の表は負の通貨額の有効なフォーマットパターンの概要を示しています。通貨額が
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
この記号は、0 よりも小さい金額をフォーマットするときに、負の金額のフォーマットと組み合わせて使用されます。マイナス記号を含まない負の金額のフォーマットでは使用されません(例えば、負の金額が括弧で囲まれている場合)。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティの値は、下の表で定義された定数のいずれかになります。
下の表は正の通貨額の有効なフォーマットパターンの概要を示しています。通貨額が
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティが
例えば、金額が 123.4 で、このプロパティが true に設定され、
次の表は、このプロパティと
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このクラスは、オペレーティングシステムによって提供される文字列比較サービスを使用します。 比較は、クラスインスタンスの作成時に提供されるロケール ID に基づいて異なります。ActionScript は Unicode 文字セットを使用して文字列を格納します。ブール値の文字列比較演算子(==、 !=、<、<=、>、>=)は、比較に Unicode コードポイントを使用します。ほとんどの場合、結果のソート順は特定の言語やロケールの規則と一致しないので、ユーザインタフェースに表示される文字列のソートに使用しないでください。 一方で、このクラスの comparison メソッドがこれらの規則に従う順序を提供します。
言語によってソート順が異なる例を次にいくつか示します。
ソート順は、同じ言語およびロケール内でも使い方によって変わる場合があります。例えば、ドイツ語では、電話帳の名前のソート順と辞書の単語のソート順は違います。漢字(日本語と中国語で使用)には、発音や部首および画数によるソートなど、様々なソート方法があります。スペイン語とグルジア語では、モダンソートとトラディショナルソートの違いがあります。
このクラスの比較メソッドには、主に 2 つの使用モードがあります。このモードは、
上記のようにロケール ID パラメーターをコンストラクターに提供した場合でも、照合動作は、ユーザーのオペレーティングシステムの設定や、要求されたロケールがサポートされていないときに代替のロケールが使用されるかどうかによって、ユーザーごとに異なる場合があります。
現在のオペレーティングシステムが
ロケール ID 「en-US」(米国の英語)で
上に示したように、すべての文字が別々の値を持つかのように扱われていますが、言語順にソートされています。
ロケール ID 「en-US」(米国の英語)で
凡例: 同じ行の文字は、比較およびソート中は等しい文字として扱われます。例えば、「a」(U+0040 = LATIN SMALL LETTER A)と「Ä」(U+00C4 = LATIN CAPITAL LETTER A WITH DIAERESIS)は等しい文字とみなされます。
上に示したように、一部の文字は言語順にソートされ、同じ文字値を持つものとして扱われています。
ソート順をさらに微調整するために、
参考のために、ロケールに依存しない標準の
上記のとおり、すべての文字が単純に Unicode の数値順にソートされています。これは言語的にはあまり意味がありません。
ユーザーの現在のオペレーティングシステム環境設定を使用するには、
ロケールによっては、ソート順のバリアントがあります。例えば、ドイツ語では、電話帳と辞書で使用されるソート順が異なります。中国語では、単語は通常、文字をぴん音に音訳することによってサポートされています。
照合文字列の有効な値を次に示します。影響を受ける言語を括弧内に示してあります。
要求された照合タイプがホストプラットフォームでサポートされない場合は、代替の照合タイプが使用され、代替が選択されたことを示すように
コンストラクターが正しく完了すると、
要求されたロケール ID を使用できない場合、
それ以外の場合、
上記の警告および
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このメソッドが呼び出されて正しく完了すると、
それ以外の場合、
このクラスが現在のオペレーティングシステムでサポートされていない場合、このメソッドは null 値を返します。
オペレーティングシステムおよび
次に実際の使用例を示します。
var fmt:Collator = new Collator(LocaleID.DEFAULT); var aliName:String = fmt.actualLocaleIDName; 上の例では、
aliName はユーザーの現在のオペレーティングシステムの設定に対応するロケールの名前(例えば、ユーザーのロケールが「イタリア語 - イタリア」に設定されている場合、「it-IT」)になり、「i-default 」(LocaleID.DEFAULT ロケールの名前)にはなりません。
次に例を示します。
var fmt:Collator = new Collator("fr-CA"); var aliName:String = fmt.actualLocaleIDName; 上の例のオペレーティングシステムが「fr-CA」(フランス語 - カナダ)ロケール ID をサポートしていないと仮定すれば、代替のロケール ID が使用されます。その場合、
aliName 変数には、代替のロケール ID「fr-FR」(フランス語 - フランス)が含まれます。
文字列の大文字と小文字の変換は、指定されたロケールのルールに従います。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
中国語と日本語の文字セットの既存の標準との互換性を保つために、Unicode では、一部の文字の全角と半角の両方に対応する文字コードを提供しています。例えば、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、
このプロパティが
例えば、このプロパティがロケール ID「en-US」に対して true の場合、ストリング「version1」、「version10」および「version2」は version1 < version2 < version10 の順でソートされます。
このプロパティが「en-US」に対して false の場合、同じストリングが version1 < version10 < version2 の順でソートされます。
このプロパティに値が割り当てられ、エラーや警告がない場合、
それ以外の場合、