指定された引数に基づいて Locale オブジェクトを返します。
説明
name は、country および variant (またはそのどちらか) により変更され、すべての使用可能なロケールに一致し、ホスト特有 (Win32 における大文字と小文字の区別のないこと、または linux における下線の許可など) に従い、最も適切な Locale が返されます。
name:
"en-US.UTF-8" または
"ja-JP" などの名前、または特別な名前
"curl"、または
"en" などの言語。名前と言語に対する標準値の説明については、
Locale.name を参照してください。
country: オプションの国別コード (
Locale.name を参照)。null ではない場合、これはハイフンに続いて、名前に追加されます。
variant: オプションのベンダー固有かつブラウザ固有のバリアント コード。null ではない場合、これはハイフンに続いて、名前に追加されます。
strict?: 通常、指定された名前が何らかの既知のロケール (大文字と小文字の区別なし) に完全に一致しない場合、同じ言語 (または使用できる言語がない場合、ホスト ロケール) のいくつかの既存ロケールが使用されます。ただし、
strict? が true の場合、
LocaleNotFoundException がスローされます。呼び出し元は、結果の
Locale オブジェクトの実際の名前を検査することに注意してください (
Locale.name を使用)。
注意事項
country または
variant なしに名前
"curl" を使用すると、Curl 構文ロケール (
get-syntax-locale を参照) が返される場合があります。
注意事項
strict? が true でない限り、返されるロケールは常に指定された言語を持ちますが、指定された言語以外の country や variant を持つこともあります。
strict? が true でない限り、正しい言語を持つシステム ロケールが存在しない場合には、指定された言語と "ZZ" の国に基づく統合的なロケールが返されます。これらの統合的なロケールは、名前を除いてホスト ロケールと同じになります。
例
これは暗黙的なファクトリーなので、
Locale が要求される場合にはいつでも
Locale 名を使用できます。
例 |
|
{format locale = "en", "%s", {DateTime}}
{format "%s", {DateTime}}
| |