Locale.ToLanguageTag メソッド

定義

名前空間:

Java.Util

アセンブリ:

Mono.Android.dll

このロケールを表す整形式の IETF BCP 47 言語タグを返します。

[Android.Runtime.Register("toLanguageTag", "()Ljava/lang/String;", "")]
public string ToLanguageTag ();

[<Android.Runtime.Register("toLanguageTag", "()Ljava/lang/String;", "")>]
member this.ToLanguageTag : unit -> string

戻り値

String

ロケールを表す BCP47 言語タグ

属性

RegisterAttribute

注釈

このロケールを表す整形式の IETF BCP 47 言語タグを返します。

IETF Locale BCP 47 言語タグの構文要件を満たしていない言語、国、またはバリアントがある場合、このメソッドは次に示すようにこれらのフィールドを処理します。

<b>言語:</b> 言語が空であるか、整形式でない場合 (例: "a"、"e2")、"und" (未決定) として出力されます。

<b>国:</b> 国が整形式でない場合 (例: "12" または "USA")、省略されます。

<b>Variant:</b> バリアント <b>が整形式の><場合、('-' または '_' で区切られた) 各サブセグメントがサブタグとして出力されます。 それ以外の場合: <ul>

<すべてのサブセグメントが一致[0-9a-zA-Z]{1,8}する場合は li>("WIN" や "Oracle_JDK_Standard_Edition"など)、最初の不適切な形式のサブセグメントと次のすべてのサブセグメントがプライベート使用サブタグに追加されます。 最初に追加されたサブタグは "lvariant" になり、その後にサブセグメントが順番に続き、ハイフンで区切られます。 たとえば、"x-lvariant-WIN"、"Oracle-x-lvariant-JDK-Standard-Edition" などです。

<li>サブセグメントが一致 [0-9a-zA-Z]{1,8}しない場合、バリアントは切り捨てられ、問題のあるサブセグメントおよび以下のすべてのサブセグメントは省略されます。 剰余が空でない場合は、上記のようにプライベート使用サブタグとして出力されます (剰余が整形式である場合でも)。 たとえば、"Solaris_isjustthecoolestthing" は "solaris" ではなく "x-lvariant-Solaris" として出力されます。</li></ul>

<b>Special Conversions:</b> Java では、互換性のために、非推奨の ISO 言語コードを含む一部の古いロケール表現がサポートされています。 このメソッドは、次の変換を実行します。 <>

<li>非推奨の ISO 言語コード "iw"、"ji"、および "in" は、それぞれ "he"、"yi"、および "id" に変換されます。

<li>ノルウェー語 (ノルウェー) を表す言語 "no"、国 "NO"、およびバリアント "NY" を持つロケールは、言語タグ "nn-NO" に変換されます。</li></ul>

<b>注:</b> このメソッドによって作成される言語タグは整形式ですが (IETF BCP 47 仕様で定義されている構文要件を満たしています)、必ずしも有効な BCP 47 言語タグであるとは限りません。 たとえば、 にします。

new Locale("xx", "YY").toLanguageTag();

は "xx-YY" を返しますが、言語サブタグ "xx" とリージョン サブタグ "YY" は IANA 言語サブタグ レジストリに登録されていないため無効です。

1.7 で追加されました。

の Java ドキュメントjava.util.Locale.toLanguageTag()

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。