Locale.ToLanguageTag メソッド

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

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

返品

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

属性

RegisterAttribute

注釈

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

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

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

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

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

<li>すべてのサブセグメントが [0-9a-zA-Z]{1,8} に一致する場合 (例: "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 言語コードなど、いくつかの古いロケール表現がサポートされています。 このメソッドは、次の変換を実行します: <ul>

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

<li>ノルウェー語 (ノルウェー) を表す言語 "no"、country "NO"、およびバリアント "NY" を持つロケールは、言語タグ "nn-NO".</li></ul>

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

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

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

1.7 で追加されました。

Javaドキュメント。

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