Locale.ForLanguageTag(String) メソッド

定義

名前空間:

Java.Util

アセンブリ:

Mono.Android.dll

指定した IETF BCP 47 言語タグ文字列のロケールを返します。

[Android.Runtime.Register("forLanguageTag", "(Ljava/lang/String;)Ljava/util/Locale;", "")]
public static Java.Util.Locale ForLanguageTag (string languageTag);

[<Android.Runtime.Register("forLanguageTag", "(Ljava/lang/String;)Ljava/util/Locale;", "")>]
static member ForLanguageTag : string -> Java.Util.Locale

パラメーター

languageTag

String

言語タグ

戻り値

Locale

言語タグを最もよく表すロケール。

属性

RegisterAttribute

例外

NullPointerException

が の場合languageTag。null

注釈

指定した IETF BCP 47 言語タグ文字列のロケールを返します。

指定した言語タグに不適切な形式のサブタグが含まれている場合、最初のそのようなサブタグと次のすべてのサブタグは無視されます。 この場合、 Locale.Builder#setLanguageTag 例外をスローする と比較します。

次 <の b>変換</b> が実行されます:<ul>

<li>言語コード "und" は言語 "" にマップされます。

<li>言語コード "he"、"yi"、および "id" はそれぞれ "iw"、"ji"、および "in" にマップされます。 (これはロケールのコンストラクターで行われるのと同じ正規化です)。

<li>プライベート使用サブタグの先頭に "lvariant" が付いた部分 (存在する場合) は削除され、結果ロケールのバリアント フィールドに追加されます (大文字と小文字の正規化は行いません)。 空の場合、プライベート使用サブタグは破棄されます。

Locale loc;
                loc = Locale.forLanguageTag("en-US-x-lvariant-POSIX");
                loc.getVariant(); // returns "POSIX"
                loc.getExtension('x'); // returns null

                loc = Locale.forLanguageTag("de-POSIX-x-URP-lvariant-Abc-Def");
                loc.getVariant(); // returns "POSIX_Abc_Def"
                loc.getExtension('x'); // returns "urp"

<li>引数 languageTag に extlang サブタグが含まれている場合、最初のサブタグが言語として使用され、第 1 言語サブタグとその他の extlang サブタグは無視されます。

Locale.forLanguageTag("ar-aao").getLanguage(); // returns "aao"
                Locale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"

<li>Case は、変更されていないバリアント タグを除いて正規化されます。 言語は小文字、スクリプトからタイトルケース、国から大文字、および小文字への拡張に正規化されます。

<li>処理後にロケールがja_JP_JPまたは拡張機能のないth_TH_THと完全に一致する場合は、コンストラクターが呼び出されたかのように適切な拡張機能が追加されます。

Locale.forLanguageTag("ja-JP-x-lvariant-JP").toLanguageTag();
               // returns "ja-JP-u-ca-japanese-x-lvariant-JP"
               Locale.forLanguageTag("th-TH-x-lvariant-TH").toLanguageTag();
               // returns "th-TH-u-nu-thai-x-lvariant-TH"

</ul>

これにより、BCP47 の "Language-Tag" の生産が実装されるため、祖父 (通常および不規則) とプライベート使用言語タグがサポートされます。 スタンドアロンのプライベート使用タグは、空の言語と拡張 'x-what'として表され、祖父のタグは存在する正規の置換に変換されます。

正規の置換を持つ祖父タグは次のとおりです。

<table class="striped">キャプション style="display:none">標準置換<を含むじじめなタグ/キャプション<>thead style="text-align:center"<>tr><th scope="col" style="padding: 0 2px">標準タグ</th><scope="col" style="padding: 0 2px">modern replacement</th></tr></thead<>tbody style="text-align:center"<>tr<><th scope="row">art-lojban</th><td>jbo</td></tr tr><<>th scope="row">i-ami</th><td>ami</td></tr tr><><th scope="row">i-bnn</th><td>bnn</td></tr tr><<>th scope="row">i-hak</th><td>hak</td></tr tr><><th scope="row">i-klingon</th><td>tlh</td></tr tr><><th scope="row">i-lux</th><td>lb</td></tr tr><><th scope="row">i-navajo</th><td>nv</td></tr tr><><th scope="row">i-pwn</th><td>pwn</td></tr tr><<>th scope="row">i-tao</th><td tao</td><>/tr tr><><th scope="row">i-tay</th><td tay</td/td>></tr tr><tr><th scope="row">i-tsu</th><td>tsu</td></tr tr><<>th scope="row">no-bok</th><td>nb</td></tr tr><<>th scope="row">no-nyn</th><td>nn</td></tr tr><<>th scope="row">sgn-BE-FR</th><td sfb</td><>/tr>><<th scope="row">sgn-BE-NL</th><td>vgt</td></tr tr><><th scope="row">sgn-CH-DE</th><td>sgg</td></tr tr><><th scope="row">zh-guoyu</th><td>cmn</td></tr tr><><th scope="row">zh-hakka</th><td>hak</td></tr th<>><scope="row">zh-min-nan/th td nan<</><td/td>></tr tr><tr><th scope="row">zh-xiang</th><td>hsn</td></tr></tbody></table>

最新の置換がない祖父タグは、次のように変換されます。

<table class="striped"><キャプション style="display:none">モダンな置換<のないじじめされたタグ/キャプション<>thead style="text-align:center"<>tr><th scope="col" style="padding: 0 2px">とじ取られたタグ</th><scope="col" style="padding: 0 2px">変換 to</th></tr></thead<>tbody style="text-align:center"><tr><thscope="row">cel-gaulish</th><td>xtg-x-cel-gaulish</td></tr tr><><th scope="row">en-GB-oed</th><td>en-GB-x-oed</td></tr tr><<>th scope="row ">i-default</th><td>en-x-i-default</td></tr tr><><th scope="row">i-enochian</th><td>und-x-i-enochian</td></tr tr><<>th scope="row">i-mingo</th><td>see-x-i-mingo</td></tr tr><<>th scope="row">zh-min</th><td>nan-x-zh-min</td></tr></tbody></table>

すべての祖父タグの一覧については、IANA 言語サブタグ レジストリを参照してください (「Type: grandfathered」を検索してください)。

<b>注</b>: と forLanguageTag が往復するtoLanguageTag保証はありません。

1.7 で追加されました。

の java.util.Locale.forLanguageTag(java.lang.String)Java ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。