語言

Locale.ToLanguageTag 方法

定義

回傳一個代表此地點的良好 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

傳回

一個代表該地點的 BCP47 語言標籤

屬性

備註

回傳一個代表此地點的良好 IETF BCP 47 語言標籤。

若此方法 Locale 有語言、國家或變體不符合 IETF BCP 47 語言標籤語法要求,則此方法將依下列方式處理這些欄位:

語言: 如果語言是空的,或不是良好形成的(例如「a」或「e2」),它會以「und」(未確定)的形式發出。

國家: 若國家不完整(例如「12」或「USA」),則會省略。

變體: 若 variant 是 良好構件,每個子段(以 '-' 或 '_' 分隔)會以子標籤形式輸出。 否則: <ul>

< >如果所有子分段都相符[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」以「x-lvariant-Solaris」形式發出,而非「solaris」。</li></ul>

特殊轉換:Java 支援部分舊的語系表示方式,包括已棄用的 ISO 語言代碼,以求相容性。 此方法執行以下轉換: <ul>

< >li 已棄用的 ISO 語言代碼「iw」、「ji」和「in」分別轉換為「he」、「yi」和「id」。

< >li 一個語言為「no」、國家「NO」及變體「NY」的地點,代表挪威語的 Nynorsk,會被轉換成語言標籤「nn-NO」。</li></ul>

注意: 雖然此方法所建立的語言標籤是格式良好的(符合 IETF BCP 47 規範所定義的語法要求),但它不一定是有效的 BCP 47 語言標籤。 例如,

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

會回傳「xx-YY」,但語言子標籤「xx」與區域子標籤「YY」因未登錄於 IANA 語言子標籤登錄而無效。

在 1.7 版本中加入。

Java 文件 java.util.Locale.toLanguageTag()。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於