Most visited

Recently visited

Added in API level 24

ULocale

public final class ULocale
extends Object implements Serializable, Comparable<ULocale>

java.lang.Object
   ↳ android.icu.util.ULocale


[icu增强] ICU的替代Locale ICU特有的方法,字段和其他功能标记为“ [icu] ”。 类似于Locale的类为ICU协议提供了额外的支持。 在ICU 3.0中,该类被增强以支持RFC 3066语言标识符。

ICU中的许多类和服务遵循工厂惯用法,其中工厂方法或对象通过对象响应客户端请求。 该请求包含语言环境( 请求的语言环境),并使用该语言环境的数据构造返回的对象。 系统可能缺少请求语言环境的数据,在这种情况下,将调用语言环境回退机制,直到找到填充的语言环境( 有效语言环境)。 此外,即使找到填充区域设置( 有效区域设置),也可能需要进一步回退才能到达包含服务所需的特定数据( 实际区域设置)的区域设置。

ULocale执行语言环境ID的“规范化”“规范化” 标准化'清理'ICU区域设置ID如下:

Canonicalization additionally performs the following: All ULocale constructors automatically normalize the locale id. To handle POSIX ids, canonicalize can be called to convert the id to canonical form, or the canonicalInstance factory method can be called.

注意: 实际的语言环境会正确返回,但在大多数情况下, 有效的语言环境不是。

也可以看看:

Summary

Nested classes

class ULocale.Builder

Builder用于根据setters配置的值构建ULocale实例。

枚举 ULocale.Category

枚举语言环境类别。

Constants

char PRIVATE_USE_EXTENSION

私人使用区域设置扩展('x')的关键。

char UNICODE_LOCALE_EXTENSION

Unicode区域扩展的关键('u')。

Fields

public static final ULocale CANADA

国家/地区的常用常数。

public static final ULocale CANADA_FRENCH

国家/地区的常用常数。

public static final ULocale CHINA

国家/地区的常用常数。

public static final ULocale CHINESE

有用的语言常数。

public static final ULocale ENGLISH

有用的语言常数。

public static final ULocale FRANCE

国家/地区的常用常数。

public static final ULocale FRENCH

有用的语言常数。

public static final ULocale GERMAN

有用的语言常数。

public static final ULocale GERMANY

国家/地区的常用常数。

public static final ULocale ITALIAN

有用的语言常数。

public static final ULocale ITALY

国家/地区的常用常数。

public static final ULocale JAPAN

国家/地区的常用常数。

public static final ULocale JAPANESE

有用的语言常数。

public static final ULocale KOREA

国家/地区的常用常数。

public static final ULocale KOREAN

有用的语言常数。

public static final ULocale PRC

国家/地区的常用常数。

public static final ULocale ROOT

根ULocale。

public static final ULocale SIMPLIFIED_CHINESE

有用的语言常数。

public static final ULocale TAIWAN

国家/地区的常用常数。

public static final ULocale TRADITIONAL_CHINESE

有用的语言常数。

public static final ULocale UK

国家/地区的常用常数。

public static final ULocale US

国家/地区的常用常数。

Public constructors

ULocale(String localeID)

[icu]根据RFC 3066区域设置标识构造一个ULocale。

ULocale(String a, String b)

为了与java.util.Locale兼容,ULocale(String,String,String)方便的重载。

ULocale(String a, String b, String c)

根据由三个'字段'a,b和c构造的localeID构造一个ULocale。

Public methods

static ULocale acceptLanguage(ULocale[] acceptLanguageList, boolean[] fallback)

[icu]根据可接受语言环境的有序数组,确定用户的可用语言环境。

static ULocale acceptLanguage(String acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)

[icu]根据可接受区域设置的HTTP格式列表,确定用户可用的区域设置。

static ULocale acceptLanguage(ULocale[] acceptLanguageList, ULocale[] availableLocales, boolean[] fallback)

[icu]根据可接受语言环境的列表,确定用户的可用语言环境。

static ULocale acceptLanguage(String acceptLanguageList, boolean[] fallback)

[icu]根据可接受区域设置的HTTP格式列表,确定用户可用的区域设置。

static ULocale addLikelySubtags(ULocale loc)

[icu]根据以下CLDR技术报告中描述的算法,为提供的区域设置ID添加可能的子标签:http://www.unicode.org/reports/tr35/#Likely_Subtags如果提供的ULocale实例已处于最大值表单,或者没有可用于最大化的数据,它将被返回。

static String canonicalize(String localeID)

[icu]返回指定区域设置标识的规范名称。

Object clone()

这是为了兼容Locale--实际上,因为ULocale是不可变的,所以没有理由克隆它,所以这个API返回'this'。

int compareTo(ULocale other)

比较两个ULocale进行排序。

static ULocale createCanonical(String nonCanonicalID)

[icu]首先对该id进行规范化,从id创建一个ULocale。

boolean equals(Object obj)

如果另一个对象是具有相同全名的另一个ULocale,则返回true。

static ULocale forLanguageTag(String languageTag)

返回指定的IETF BCP 47语言标记字符串的语言环境。

static ULocale forLocale(Locale loc)

[ICU]返回给一个ULocale对象 Locale

static ULocale[] getAvailableLocales()

[icu]注意:与Locale API不同,这将返回 ULocale的数组,而不是 Locale

String getBaseName()

[icu]返回此语言环境的(标准化)基本名称,如 getName() ,但没有关键字。

static String getBaseName(String localeID)

[icu]返回指定语言环境的(标准化)基本名称,如 getName(String) ,但不包含关键字。

String getCharacterOrientation()

[icu]返回此语言环境的字符布局方向。

static String getCountry(String localeID)

[icu]返回此语言环境的国家/地区代码,该代码可以是空字符串,也可以是大写的ISO 3166 2字母代码。

String getCountry()

返回此语言环境的国家/地区代码,该代码可以是空字符串,也可以是大写的ISO 3166 2字母代码。

static ULocale getDefault()

返回当前的默认ULocale。

static ULocale getDefault(ULocale.Category category)

返回指定类别的当前默认ULocale。

String getDisplayCountry()

返回本地化的国家/地区,以默认 DISPLAY区域设置显示。

static String getDisplayCountry(String localeID, String displayLocaleID)

[icu]返回本地化的国家/地区,用于在提供的语言环境中显示。

String getDisplayCountry(ULocale displayLocale)

返回本地化的国家/地区,以便在提供的区域设置中显示。

static String getDisplayCountry(String localeID, ULocale displayLocale)

[icu]返回本地化的国家/地区,用于在提供的语言环境中显示。

static String getDisplayKeyword(String keyword, ULocale displayLocale)

[icu]返回一个关键字,用于在指定的区域中显示。

static String getDisplayKeyword(String keyword, String displayLocaleID)

[icu]返回一个关键字,用于在指定的区域中显示。

static String getDisplayKeyword(String keyword)

[icu]返回一个关键字,用于在默认的 DISPLAY语言环境中进行本地化显示。

static String getDisplayKeywordValue(String localeID, String keyword, String displayLocaleID)

[icu]返回本地化的关键字值,以便在指定的语言环境中显示。

static String getDisplayKeywordValue(String localeID, String keyword, ULocale displayLocale)

[icu]返回本地化的关键字值,以便在指定的语言环境中显示。

String getDisplayKeywordValue(String keyword)

[icu]返回一个关键字值,以默认的 DISPLAY语言环境显示。

String getDisplayKeywordValue(String keyword, ULocale displayLocale)

[icu]返回本地化的关键字值,以便在指定的语言环境中显示。

String getDisplayLanguage(ULocale displayLocale)

返回本地化的语言,用于在提供的语言环境中显示。

static String getDisplayLanguage(String localeID, ULocale displayLocale)

[icu]返回本地化的语言,用于在提供的语言环境中显示。

static String getDisplayLanguage(String localeID, String displayLocaleID)

[icu]返回本地化的语言,用于在提供的语言环境中显示。

String getDisplayLanguage()

返回本地化的语言,以默认的 DISPLAY语言环境显示。

String getDisplayLanguageWithDialect(ULocale displayLocale)

[icu]返回本地化的语言,用于在提供的语言环境中显示。

static String getDisplayLanguageWithDialect(String localeID, String displayLocaleID)

[icu]返回本地化的语言,用于在提供的语言环境中显示。

static String getDisplayLanguageWithDialect(String localeID, ULocale displayLocale)

[icu]返回本地化的语言,用于在提供的语言环境中显示。

String getDisplayLanguageWithDialect()

[icu]返回本地化的语言,以默认的 DISPLAY语言环境显示。

String getDisplayName()

返回此语言环境名称,以便在默认的 DISPLAY语言环境中进行显示。

String getDisplayName(ULocale displayLocale)

返回本地化名称,用于在提供的语言环境中显示。

static String getDisplayName(String localeID, String displayLocaleID)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。

static String getDisplayName(String localeID, ULocale displayLocale)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。

static String getDisplayNameWithDialect(String localeID, String displayLocaleID)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。

static String getDisplayNameWithDialect(String localeID, ULocale displayLocale)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。

String getDisplayNameWithDialect(ULocale displayLocale)

[icu]返回本地化名称,用于在提供的语言环境中显示。

String getDisplayNameWithDialect()

[icu]返回本地化名称,以便在默认的 DISPLAY语言环境中显示。

static String getDisplayScript(String localeID, String displayLocaleID)

[icu]返回本地化的脚本,用于在提供的语言环境中显示。

static String getDisplayScript(String localeID, ULocale displayLocale)

[icu]返回本地化的脚本,用于在提供的语言环境中显示。

String getDisplayScript()

返回本地化的脚本,用于在默认的 DISPLAY语言环境中显示。

String getDisplayScript(ULocale displayLocale)

返回本地化的脚本,用于在提供的语言环境中显示。

static String getDisplayVariant(String localeID, String displayLocaleID)

[icu]返回本地化的变体,用于在提供的语言环境中显示。

String getDisplayVariant()

返回此语言环境的本地化版本,以默认的 DISPLAY语言环境显示。

String getDisplayVariant(ULocale displayLocale)

返回本地化的变体,用于在提供的区域中显示。

static String getDisplayVariant(String localeID, ULocale displayLocale)

[icu]返回本地化的变体,用于在提供的语言环境中显示。

String getExtension(char key)

返回与指定键关联的扩展名(或私有用途)值,如果没有与键关联的扩展名,则返回null。

Set<Character> getExtensionKeys()

返回与此语言环境相关联的扩展键集合,如果没有扩展名,则返回空集合。

ULocale getFallback()

[icu]返回此语言环境的回退语言环境。

static String getFallback(String localeID)

[icu]返回指定语言环境的回退语言环境,该语言环境可能是空字符串。

String getISO3Country()

返回此区域设置的国家/地区的三字母缩写。

static String getISO3Country(String localeID)

[icu]返回此语言环境的国家/地区的三字母缩写。

String getISO3Language()

返回此语言环境语言的三字母缩写。

static String getISO3Language(String localeID)

[icu]返回此语言环境语言的三字母缩写。

static String[] getISOCountries()

返回ISO 3166中定义的所有双字母国家代码的列表。

static String[] getISOLanguages()

返回ISO 639中定义的所有2字母语言代码的列表。

static String getKeywordValue(String localeID, String keywordName)

[icu]返回指定语言环境中关键字的值。

String getKeywordValue(String keywordName)

[icu]返回此语言环境中关键字的值。

static Iterator<String> getKeywords(String localeID)

[icu]返回指定区域设置的关键字迭代器。

Iterator<String> getKeywords()

[icu]返回此语言环境的关键字迭代器。

static String getLanguage(String localeID)

返回区域设置ID的语言代码,该代码可以是空字符串或小写的ISO 639代码。

String getLanguage()

返回此语言环境的语言代码,该代码将是空字符串或小写的ISO 639代码。

String getLineOrientation()

[icu]返回此语言环境的线条布局方向。

String getName()

[icu]返回此语言环境的(标准化)全名。

static String getName(String localeID)

[icu]返回指定语言环境的(标准化)全名。

String getScript()

返回此语言环境的脚本代码,可能是空字符串。

static String getScript(String localeID)

[icu]返回指定语言环境的脚本代码,可能是空字符串。

Set<String> getUnicodeLocaleAttributes()

返回与此语言环境相关联的unicode语言环境属性集合,如果没有属性,则返回空集合。

Set<String> getUnicodeLocaleKeys()

返回由此语言环境定义的Unicode区域设置键集合,如果此语言环境没有,则返回空集合。

String getUnicodeLocaleType(String key)

返回与此语言环境的指定Unicode区域设置键相关联的Unicode区域设置类型。

String getVariant()

返回此语言环境的变体代码,可能是空字符串。

static String getVariant(String localeID)

[icu]返回指定语言环境的变体代码,可能是空字符串。

int hashCode()

返回hashCode。

boolean isRightToLeft()

[icu]返回此语言环境的脚本是否从右向左书写。

static ULocale minimizeSubtags(ULocale loc)

[icu]按照以下CLDR技术报告中描述的算法,最小化提供的区域设置标识的子标记:

http://www.unicode.org/reports/tr35/#Likely_Subtags
If the provided ULocale instance is already in the minimal form, or there is no data available for minimization, it will be returned.

ULocale setKeywordValue(String keyword, String value)

[icu]给定一个关键字和一个值,返回一个新的语言环境,其中包含一个更新后的关键字和值。

static String setKeywordValue(String localeID, String keyword, String value)

给定一个语言环境ID,一个关键字和一个值,返回一个新的语言环境ID与更新的关键字和值。

String toLanguageTag()

返回表示此语言环境的格式良好的IETF BCP 47语言标记。

static String toLegacyKey(String keyword)

[icu]将指定的关键字(BCP 47 Unicode区域设置扩展密钥或旧密钥)转换为旧密钥。

static String toLegacyType(String keyword, String value)

[icu]将指定的关键字值(BCP 47 Unicode区域设置扩展类型或旧式类型或类型别名)转换为规范旧式类型。

Locale toLocale()

[icu]将此ULocale对象转换为 Locale

String toString()

返回此对象的字符串表示形式。

static String toUnicodeLocaleKey(String keyword)

[icu]将指定关键字(传统密钥或BCP 47 Unicode区域设置扩展密钥)转换为等效的BCP 47 Unicode区域设置扩展密钥。

static String toUnicodeLocaleType(String keyword, String value)

[icu]将指定的关键字值(传统类型或BCP 47 Unicode区域设置扩展类型)转换为指定关键字(类别)格式良好的BCP 47 Unicode区域设置扩展类型。

Inherited methods

From class java.lang.Object
From interface java.lang.Comparable

Constants

PRIVATE_USE_EXTENSION

Added in API level 24
char PRIVATE_USE_EXTENSION

私人使用区域设置扩展('x')的关键。

也可以看看:

常量值:120(0x00000078)

UNICODE_LOCALE_EXTENSION

Added in API level 24
char UNICODE_LOCALE_EXTENSION

Unicode区域扩展的关键('u')。

也可以看看:

常量值:117(0x00000075)

Fields

CANADA

Added in API level 24
ULocale CANADA

国家/地区的常用常数。

CANADA_FRENCH

Added in API level 24
ULocale CANADA_FRENCH

国家/地区的常用常数。

CHINA

Added in API level 24
ULocale CHINA

国家/地区的常用常数。

CHINESE

Added in API level 24
ULocale CHINESE

有用的语言常数。

ENGLISH

Added in API level 24
ULocale ENGLISH

有用的语言常数。

FRANCE

Added in API level 24
ULocale FRANCE

国家/地区的常用常数。

FRENCH

Added in API level 24
ULocale FRENCH

有用的语言常数。

GERMAN

Added in API level 24
ULocale GERMAN

有用的语言常数。

GERMANY

Added in API level 24
ULocale GERMANY

国家/地区的常用常数。

ITALIAN

Added in API level 24
ULocale ITALIAN

有用的语言常数。

ITALY

Added in API level 24
ULocale ITALY

国家/地区的常用常数。

JAPAN

Added in API level 24
ULocale JAPAN

国家/地区的常用常数。

JAPANESE

Added in API level 24
ULocale JAPANESE

有用的语言常数。

KOREA

Added in API level 24
ULocale KOREA

国家/地区的常用常数。

KOREAN

Added in API level 24
ULocale KOREAN

有用的语言常数。

PRC

Added in API level 24
ULocale PRC

国家/地区的常用常数。

ROOT

Added in API level 24
ULocale ROOT

根ULocale。

SIMPLIFIED_CHINESE

Added in API level 24
ULocale SIMPLIFIED_CHINESE

有用的语言常数。

TAIWAN

Added in API level 24
ULocale TAIWAN

国家/地区的常用常数。

TRADITIONAL_CHINESE

Added in API level 24
ULocale TRADITIONAL_CHINESE

有用的语言常数。

UK

Added in API level 24
ULocale UK

国家/地区的常用常数。

US

Added in API level 24
ULocale US

国家/地区的常用常数。

Public constructors

ULocale

Added in API level 24
ULocale (String localeID)

[icu]根据RFC 3066区域设置标识构造一个ULocale。 区域设置ID由可选语言,脚本,国家和变体字段按顺序组成,用下划线分隔,后跟可选关键字列表。 该脚本如果存在,则为四个字符 - 这与区分长度为两个字符的国家代码不同。 其他字段按下划线所示的位置加以区分。 关键字列表的开头用'@'表示,并且由两个或多个用分号(';')分隔的关键字/值对组成。

这个构造函数没有规范localeID。 因此,例如,“zh__拼音”保持不变,而不是转换为“zh @ collation = pinyin”。 默认情况下,ICU仅将后者识别为指定拼音排序。 使用createCanonical(String)或者canonicalize(String)如果你需要规范化已将LocaleID。

Parameters
localeID String: string representation of the locale, e.g: "en_US", "sy_Cyrl_YU", "zh__pinyin", "es_ES@currency=EUR;collation=traditional"

ULocale

Added in API level 24
ULocale (String a, 
                String b)

为了与java.util.Locale兼容,ULocale(String,String,String)方便的重载。

Parameters
a String
b String

也可以看看:

ULocale

Added in API level 24
ULocale (String a, 
                String b, 
                String c)

根据由三个'字段'a,b和c构造的localeID构造一个ULocale。 这些字段使用下划线连接形成a_b_c形式的localeID,然后像传递给ULocale(String localeID)的localeID一样处理。

由语言,国家和变体组成的Java语言环境字符串将由此表格处理,因为国家代码(短于四个字母长)不会被解释为脚本代码。 如果存在脚本代码,则最终参数('c')将被解释为国家代码。 建议此构造函数仅用于简化移植操作,而客户端则是在从localeID构造ULocale时使用单参数构造函数。

Parameters
a String: first component of the locale id
b String: second component of the locale id
c String: third component of the locale id

也可以看看:

Public methods

acceptLanguage

Added in API level 24
ULocale acceptLanguage (ULocale[] acceptLanguageList, 
                boolean[] fallback)

[icu]根据可接受语言环境的有序数组,确定用户的可用语言环境。 如果acceptLanguageList或availableLocales为null,则抛出NullPointerException。 如果回退是非空值,则在返回回退语言环境(不在acceptLanguageList中)时,它将包含true。 输入值被忽略。 如果ROOT语言环境用作回退(因为availableLocales中没有其他内容匹配),ULocale将成为availableLocales中的语言环境之一,或ROOT ULocale。 没有ULocale数组元素应该为空; 行为是不确定的,如果是这种情况。 该功能将从ULocale.getAvailableLocales()列表中选择一个可用的语言环境。

Parameters
acceptLanguageList ULocale: ordered array of acceptable locales (preferred are listed first)
fallback boolean: if non-null, a 1-element array containing a boolean to be set with the fallback status
Returns
ULocale one of the locales from the ULocale.getAvailableLocales() list, or null if none match

acceptLanguage

Added in API level 24
ULocale acceptLanguage (String acceptLanguageList, 
                ULocale[] availableLocales, 
                boolean[] fallback)

[icu]根据可接受区域设置的HTTP格式列表,确定用户可用的区域设置。 如果acceptLanguageList或availableLocales为null,则抛出NullPointerException。 如果回退是非空值,则在返回回退语言环境(不在acceptLanguageList中)时,它将包含true。 输入值被忽略。 如果ROOT语言环境用作回退(因为availableLocales中没有其他内容匹配),ULocale将成为availableLocales中的语言环境之一,或ROOT ULocale。 没有ULocale数组元素应该为空; 行为是不确定的,如果是这种情况。

Parameters
acceptLanguageList String: list in HTTP "Accept-Language:" format of acceptable locales
availableLocales ULocale: list of available locales. One of these will be returned.
fallback boolean: if non-null, a 1-element array containing a boolean to be set with the fallback status
Returns
ULocale one of the locales from the availableLocales list, or null if none match

acceptLanguage

Added in API level 24
ULocale acceptLanguage (ULocale[] acceptLanguageList, 
                ULocale[] availableLocales, 
                boolean[] fallback)

[icu]根据可接受语言环境的列表,确定用户的可用语言环境。 如果acceptLanguageList或availableLocales为null,则抛出NullPointerException。 如果回退是非空值,则在返回回退语言环境(不在acceptLanguageList中)时,它将包含true。 输入值被忽略。 如果ROOT语言环境用作回退(因为availableLocales中没有其他内容匹配),ULocale将成为availableLocales中的语言环境之一,或ROOT ULocale。 没有ULocale数组元素应该为空; 行为是不确定的,如果是这种情况。

Parameters
acceptLanguageList ULocale: list of acceptable locales
availableLocales ULocale: list of available locales. One of these will be returned.
fallback boolean: if non-null, a 1-element array containing a boolean to be set with the fallback status
Returns
ULocale one of the locales from the availableLocales list, or null if none match

acceptLanguage

Added in API level 24
ULocale acceptLanguage (String acceptLanguageList, 
                boolean[] fallback)

[icu]根据可接受区域设置的HTTP格式列表,确定用户可用的区域设置。 如果acceptLanguageList或availableLocales为null,则抛出NullPointerException。 如果回退是非空值,则在返回回退语言环境(不在acceptLanguageList中)时,它将包含true。 输入值被忽略。 如果ROOT语言环境用作回退(因为availableLocales中没有其他内容匹配),ULocale将成为availableLocales中的语言环境之一,或ROOT ULocale。 没有ULocale数组元素应该为空; 行为是不确定的,如果是这种情况。 该功能将从ULocale.getAvailableLocales()列表中选择一个可用的语言环境。

Parameters
acceptLanguageList String: list in HTTP "Accept-Language:" format of acceptable locales
fallback boolean: if non-null, a 1-element array containing a boolean to be set with the fallback status
Returns
ULocale one of the locales from the ULocale.getAvailableLocales() list, or null if none match

addLikelySubtags

Added in API level 24
ULocale addLikelySubtags (ULocale loc)

[icu]根据以下CLDR技术报告中描述的算法,为提供的区域设置ID添加可能的子标签:http://www.unicode.org/reports/tr35/#Likely_Subtags如果提供的ULocale实例已处于最大值表单,或者没有可用于最大化的数据,它将被返回。 例如,“und-Zzzz”不能最大化,因为没有合理的最大化。 否则,返回具有最大形式的新ULocale实例。 示例:“en”最大化为“en_Latn_US”“de”最大化为“de_Latn_US”“sr”最大化为“sr_Cyrl_RS”“sh”最大化为“sr_Latn_RS”(注意这不会反转)。“zh_Hani”最大化为“zh_Hans_CN” (请注意,这不会逆转。)

Parameters
loc ULocale: The ULocale to maximize
Returns
ULocale The maximized ULocale instance.

canonicalize

Added in API level 24
String canonicalize (String localeID)

[icu]返回指定区域设置标识的规范名称。 这用于将POSIX和其他老式ID转换为标准ICU形式。

Parameters
localeID String: the locale id
Returns
String the canonicalized id

clone

Added in API level 24
Object clone ()

这是为了兼容Locale--实际上,因为ULocale是不可变的,所以没有理由克隆它,所以这个API返回'this'。

Returns
Object a clone of this instance.

compareTo

Added in API level 24
int compareTo (ULocale other)

比较两个ULocale进行排序。

注意:订单将来可能会更改。

Parameters
other ULocale: the ULocale to be compared.
Returns
int a negative integer, zero, or a positive integer as this ULocale is less than, equal to, or greater than the specified ULocale.
Throws
NullPointerException if other is null.

createCanonical

Added in API level 24
ULocale createCanonical (String nonCanonicalID)

[icu]首先对该id进行规范化,从id创建一个ULocale。

Parameters
nonCanonicalID String: the locale id to canonicalize
Returns
ULocale the locale created from the canonical version of the ID.

equals

Added in API level 24
boolean equals (Object obj)

如果另一个对象是具有相同全名的另一个ULocale,则返回true。 请注意,由于名称不是规范化的,所以两个功能相同的ULocales可能不会相等。

Parameters
obj Object: the reference object with which to compare.
Returns
boolean true if this Locale is equal to the specified object.

forLanguageTag

Added in API level 24
ULocale forLanguageTag (String languageTag)

返回指定的IETF BCP 47语言标记字符串的语言环境。

如果指定的语言标签包含任何不合格的子标签,则会忽略第一个此类子标签和所有后续子标签。 与在这种情况下抛出异常的setLanguageTag(String)相比较。

执行以下 转换

  • The language code "und" is mapped to language "".
  • The portion of a private use subtag prefixed by "lvariant", if any, is removed and appended to the variant field in the result locale (without case normalization). If it is then empty, the private use subtag is discarded:
         ULocale loc;
         loc = ULocale.forLanguageTag("en-US-x-lvariant-icu4j);
         loc.getVariant(); // returns "ICU4J"
         loc.getExtension('x'); // returns null
    
         loc = Locale.forLanguageTag("de-icu4j-x-URP-lvariant-Abc-Def");
         loc.getVariant(); // returns "ICU4J_ABC_DEF"
         loc.getExtension('x'); // returns "urp"
     
  • When the languageTag argument contains an extlang subtag, the first such subtag is used as the language, and the primary language subtag and other extlang subtags are ignored:
         ULocale.forLanguageTag("ar-aao").getLanguage(); // returns "aao"
         ULocale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"
     
  • Case is normalized. Language is normalized to lower case, script to title case, country to upper case, variant to upper case, and extensions to lower case.

这实现了BCP47的'语言标签'生产,因此支持祖父(定期和不定期)以及私人使用的语言标签。 独立的私人使用标签被表示为空语言和扩展名'x-whatever',并且祖先风格的标签被转换为它们存在的规范替换。

带有规范替换的Grandfathered标签如下所示:

grandfathered tag   modern replacement
art-lojban   jbo
i-ami   ami
i-bnn   bnn
i-hak   hak
i-klingon   tlh
i-lux   lb
i-navajo   nv
i-pwn   pwn
i-tao   tao
i-tay   tay
i-tsu   tsu
no-bok   nb
no-nyn   nn
sgn-BE-FR   sfb
sgn-BE-NL   vgt
sgn-CH-DE   sgg
zh-guoyu   cmn
zh-hakka   hak
zh-min-nan   nan
zh-xiang   hsn

没有现代替代品的Grandfathered标签将被转换如下:

grandfathered tag   converts to
cel-gaulish   xtg-x-cel-gaulish
en-GB-oed   en-GB-x-oed
i-default   en-x-i-default
i-enochian   und-x-i-enochian
i-mingo   see-x-i-mingo
zh-min   nan-x-zh-min

有关所有祖父标记的列表,请参阅IANA语言标签注册表(搜索“类型:祖父”)。

注意toLanguageTagforLanguageTag不能保证往返。

Parameters
languageTag String: the language tag
Returns
ULocale The locale that best represents the language tag.
Throws
NullPointerException if languageTag is null

也可以看看:

forLocale

Added in API level 24
ULocale forLocale (Locale loc)

[ICU]返回给一个ULocale对象Locale ULocale是规范化的。

Parameters
loc Locale: a Locale
Returns
ULocale

getAvailableLocales

Added in API level 24
ULocale[] getAvailableLocales ()

[icu]注意:与Locale API不同,这将返回ULocale的数组,而不是Locale 返回所有已安装语言环境的列表。

Returns
ULocale[]

getBaseName

Added in API level 24
String getBaseName ()

[icu]返回此语言环境的(标准化)基本名称,如 getName() ,但没有关键字。

Returns
String the base name as a String.

getBaseName

Added in API level 24
String getBaseName (String localeID)

[icu]返回指定语言环境的(标准化)基本名称,如 getName(String) ,但不包含关键字。

Parameters
localeID String: the locale ID as a string
Returns
String the base name as a String.

getCharacterOrientation

Added in API level 24
String getCharacterOrientation ()

[icu]返回此语言环境的字符布局方向。 可能的值是“从左到右”,“从右到左”,“从上到下”或“从下到上”。

Returns
String The locale's layout orientation for characters.

getCountry

Added in API level 24
String getCountry (String localeID)

[icu]返回此语言环境的国家/地区代码,该代码可以是空字符串,也可以是大写的ISO 3166 2字母代码。

Parameters
localeID String: The locale identification string.
Returns
String

也可以看看:

getCountry

Added in API level 24
String getCountry ()

返回此语言环境的国家/地区代码,该代码可以是空字符串,也可以是大写的ISO 3166 2字母代码。

Returns
String

也可以看看:

getDefault

Added in API level 24
ULocale getDefault ()

返回当前的默认ULocale。

默认的ULocale被同步到默认的Java语言环境。 此方法检查当前的默认Java语言环境并返回等效的ULocale。

Returns
ULocale the default ULocale.

getDefault

Added in API level 24
ULocale getDefault (ULocale.Category category)

返回指定类别的当前默认ULocale。

Parameters
category ULocale.Category: the category
Returns
ULocale the default ULocale for the specified category.

getDisplayCountry

Added in API level 24
String getDisplayCountry ()

返回本地化的国家/地区,以默认DISPLAY区域设置显示。 警告:这是区域有效区域设置ID的一部分; 它不能只是区域代码(如“FR”)。 要获取单独区域或其他选项的显示名称, LocaleDisplayNames改为使用LocaleDisplayNames

Returns
String the localized country name.

也可以看看:

getDisplayCountry

Added in API level 24
String getDisplayCountry (String localeID, 
                String displayLocaleID)

[icu]返回本地化的国家/地区,用于在提供的语言环境中显示。 警告:这是区域有效区域设置ID的一部分; 它不能只是区域代码(如“FR”)。 要获取单独区域或其他选项的显示名称, LocaleDisplayNames改为使用LocaleDisplayNames 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose country will be displayed
displayLocaleID String: the id of the locale in which to display the name.
Returns
String the localized country name.

getDisplayCountry

Added in API level 24
String getDisplayCountry (ULocale displayLocale)

返回本地化的国家/地区,以便在提供的区域设置中显示。 警告:这是区域有效区域设置ID的一部分; 它不能只是区域代码(如“FR”)。 要获取单独区域或其他选项的显示名称, LocaleDisplayNames改为使用LocaleDisplayNames

Parameters
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized country name.

getDisplayCountry

Added in API level 24
String getDisplayCountry (String localeID, 
                ULocale displayLocale)

[icu]返回本地化的国家/地区,用于在提供的语言环境中显示。 警告:这是区域有效区域设置ID的一部分; 它不能只是区域代码(如“FR”)。 要获取某个区域的显示名称或其他选项, LocaleDisplayNames改为使用LocaleDisplayNames 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose country will be displayed.
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized country name.

getDisplayKeyword

Added in API level 24
String getDisplayKeyword (String keyword, 
                ULocale displayLocale)

[icu]返回一个关键字,用于在指定的区域中显示。

Parameters
keyword String: the keyword to be displayed.
displayLocale ULocale: the locale in which to display the keyword.
Returns
String the localized keyword name.

也可以看看:

getDisplayKeyword

Added in API level 24
String getDisplayKeyword (String keyword, 
                String displayLocaleID)

[icu]返回一个关键字,用于在指定的区域中显示。

Parameters
keyword String: the keyword to be displayed.
displayLocaleID String: the id of the locale in which to display the keyword.
Returns
String the localized keyword name.

也可以看看:

getDisplayKeyword

Added in API level 24
String getDisplayKeyword (String keyword)

[icu]返回一个关键字,用于在默认 DISPLAY区域设置中显示。

Parameters
keyword String: the keyword to be displayed.
Returns
String the localized keyword name.

也可以看看:

getDisplayKeywordValue

Added in API level 24
String getDisplayKeywordValue (String localeID, 
                String keyword, 
                String displayLocaleID)

[icu]返回本地化的关键字值,以便在指定的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose keyword value is to be displayed.
keyword String: the keyword whose value is to be displayed.
displayLocaleID String: the id of the locale in which to display the value.
Returns
String the localized value name.

getDisplayKeywordValue

Added in API level 24
String getDisplayKeywordValue (String localeID, 
                String keyword, 
                ULocale displayLocale)

[icu]返回本地化的关键字值,以便在指定的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose keyword value is to be displayed.
keyword String: the keyword whose value is to be displayed.
displayLocale ULocale: the id of the locale in which to display the value.
Returns
String the localized value name.

getDisplayKeywordValue

Added in API level 24
String getDisplayKeywordValue (String keyword)

[icu]返回本地化的关键字值,以默认的 DISPLAY语言环境显示。

Parameters
keyword String: the keyword whose value is to be displayed.
Returns
String the localized value name.

也可以看看:

getDisplayKeywordValue

Added in API level 24
String getDisplayKeywordValue (String keyword, 
                ULocale displayLocale)

[icu]返回本地化的关键字值,以便在指定的语言环境中显示。

Parameters
keyword String: the keyword whose value is to be displayed.
displayLocale ULocale: the locale in which to display the value.
Returns
String the localized value name.

getDisplayLanguage

Added in API level 24
String getDisplayLanguage (ULocale displayLocale)

返回本地化的语言,用于在提供的语言环境中显示。

Parameters
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized language name.

getDisplayLanguage

Added in API level 24
String getDisplayLanguage (String localeID, 
                ULocale displayLocale)

[icu]返回本地化的语言,用于在提供的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose language will be displayed.
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized language name.

getDisplayLanguage

Added in API level 24
String getDisplayLanguage (String localeID, 
                String displayLocaleID)

[icu]返回本地化的语言,用于在提供的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose language will be displayed
displayLocaleID String: the id of the locale in which to display the name.
Returns
String the localized language name.

getDisplayLanguage

Added in API level 24
String getDisplayLanguage ()

返回本地化的语言,以默认的 DISPLAY语言环境显示。

Returns
String the localized language name.

也可以看看:

getDisplayLanguageWithDialect

Added in API level 24
String getDisplayLanguageWithDialect (ULocale displayLocale)

[icu]返回本地化的语言,用于在提供的语言环境中显示。 如果数据中存在方言名称,则返回。

Parameters
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized language name.

getDisplayLanguageWithDialect

Added in API level 24
String getDisplayLanguageWithDialect (String localeID, 
                String displayLocaleID)

[icu]返回本地化的语言,用于在提供的语言环境中显示。 如果数据中存在方言名称,则返回。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose language will be displayed
displayLocaleID String: the id of the locale in which to display the name.
Returns
String the localized language name.

getDisplayLanguageWithDialect

Added in API level 24
String getDisplayLanguageWithDialect (String localeID, 
                ULocale displayLocale)

[icu]返回本地化的语言,用于在提供的语言环境中显示。 如果数据中存在方言名称,则返回。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose language will be displayed.
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized language name.

getDisplayLanguageWithDialect

Added in API level 24
String getDisplayLanguageWithDialect ()

[icu]返回本地化的语言,以默认的DISPLAY语言环境显示。 如果数据中存在方言名称,则返回。

Returns
String the localized language name.

也可以看看:

getDisplayName

Added in API level 24
String getDisplayName ()

返回本地化名称,以便在默认的 DISPLAY语言环境中显示。

Returns
String the localized locale name.

也可以看看:

getDisplayName

Added in API level 24
String getDisplayName (ULocale displayLocale)

返回本地化名称,用于在提供的语言环境中显示。

Parameters
displayLocale ULocale: the locale in which to display the locale name.
Returns
String the localized locale name.

getDisplayName

Added in API level 24
String getDisplayName (String localeID, 
                String displayLocaleID)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the locale whose name is to be displayed.
displayLocaleID String: the id of the locale in which to display the locale name.
Returns
String the localized locale name.

getDisplayName

Added in API level 24
String getDisplayName (String localeID, 
                ULocale displayLocale)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the locale whose name is to be displayed.
displayLocale ULocale: the locale in which to display the locale name.
Returns
String the localized locale name.

getDisplayNameWithDialect

Added in API level 24
String getDisplayNameWithDialect (String localeID, 
                String displayLocaleID)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。 如果区域设置数据中存在方言名称,则返回该方言名称。 这是ICU4C API的封面。

Parameters
localeID String: the locale whose name is to be displayed.
displayLocaleID String: the id of the locale in which to display the locale name.
Returns
String the localized locale name.

getDisplayNameWithDialect

Added in API level 24
String getDisplayNameWithDialect (String localeID, 
                ULocale displayLocale)

[icu]返回本地化的区域ID,用于在提供的语言环境中显示。 如果区域设置数据中存在方言名称,则返回该方言名称。 这是ICU4C API的封面。

Parameters
localeID String: the locale whose name is to be displayed.
displayLocale ULocale: the locale in which to display the locale name.
Returns
String the localized locale name.

getDisplayNameWithDialect

Added in API level 24
String getDisplayNameWithDialect (ULocale displayLocale)

[icu]返回本地化名称,用于在提供的语言环境中显示。 如果区域设置数据中存在方言名称,则返回该方言名称。

Parameters
displayLocale ULocale: the locale in which to display the locale name.
Returns
String the localized locale name.

getDisplayNameWithDialect

Added in API level 24
String getDisplayNameWithDialect ()

[icu]返回本地化名称,以便在默认的DISPLAY语言环境中显示。 如果区域设置数据中存在方言名称,则返回该方言名称。

Returns
String the localized locale name.

也可以看看:

getDisplayScript

Added in API level 24
String getDisplayScript (String localeID, 
                String displayLocaleID)

[icu]返回本地化的脚本,用于在提供的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose script will be displayed
displayLocaleID String: the id of the locale in which to display the name.
Returns
String the localized script name.

getDisplayScript

Added in API level 24
String getDisplayScript (String localeID, 
                ULocale displayLocale)

[icu]返回本地化的脚本,用于在提供的语言环境中显示。

Parameters
localeID String: the id of the locale whose script will be displayed.
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized script name.

getDisplayScript

Added in API level 24
String getDisplayScript ()

返回本地化的脚本,以便在默认的 DISPLAY语言环境中显示。

Returns
String the localized script name.

也可以看看:

getDisplayScript

Added in API level 24
String getDisplayScript (ULocale displayLocale)

返回本地化的脚本,用于在提供的语言环境中显示。

Parameters
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized script name.

getDisplayVariant

Added in API level 24
String getDisplayVariant (String localeID, 
                String displayLocaleID)

[icu]返回本地化的变体,用于在提供的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose variant will be displayed
displayLocaleID String: the id of the locale in which to display the name.
Returns
String the localized variant name.

getDisplayVariant

Added in API level 24
String getDisplayVariant ()

返回此语言环境的本地化版本,以默认的 DISPLAY语言环境显示。

Returns
String the localized variant name.

也可以看看:

getDisplayVariant

Added in API level 24
String getDisplayVariant (ULocale displayLocale)

返回本地化的变体,用于在提供的区域中显示。

Parameters
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized variant name.

getDisplayVariant

Added in API level 24
String getDisplayVariant (String localeID, 
                ULocale displayLocale)

[icu]返回本地化的变体,用于在提供的语言环境中显示。 这是ICU4C API的封面。

Parameters
localeID String: the id of the locale whose variant will be displayed.
displayLocale ULocale: the locale in which to display the name.
Returns
String the localized variant name.

getExtension

Added in API level 24
String getExtension (char key)

返回与指定键关联的扩展名(或私有用途)值,如果没有与键关联的扩展名,则返回null。 要形成良好的关键必须是[0-9A-Za-z] 密钥不区分大小写,例如'z'和'Z'代表相同的扩展名。

Parameters
key char: the extension key
Returns
String The extension, or null if this locale defines no extension for the specified key.
Throws
IllegalArgumentException if key is not well-formed

也可以看看:

getExtensionKeys

Added in API level 24
Set<Character> getExtensionKeys ()

返回与此语言环境相关联的扩展键集合,如果没有扩展名,则返回空集合。 返回的集合是不可修改的。 钥匙都是小写的。

Returns
Set<Character> the set of extension keys, or the empty set if this locale has no extensions

getFallback

Added in API level 24
ULocale getFallback ()

[icu]返回此语言环境的回退语言环境。 如果此区域设置为root,则返回null。

Returns
ULocale

getFallback

Added in API level 24
String getFallback (String localeID)

[icu]返回指定语言环境的回退语言环境,该语言环境可能是空字符串。

Parameters
localeID String
Returns
String

getISO3Country

Added in API level 24
String getISO3Country ()

返回此区域设置的国家/地区的三字母缩写。 如果区域设置未指定国家,则返回空字符串。 否则,返回一个大写的ISO 3166 3个字母的国家代码。

Returns
String
Throws
MissingResourceException Throws MissingResourceException if the three-letter country abbreviation is not available for this locale.

getISO3Country

Added in API level 24
String getISO3Country (String localeID)

[icu]返回此语言环境的国家/地区的三字母缩写。 如果区域设置未指定国家,则返回空字符串。 否则,返回一个大写的ISO 3166 3个字母的国家代码。

Parameters
localeID String
Returns
String
Throws
MissingResourceException Throws MissingResourceException if the three-letter country abbreviation is not available for this locale.

getISO3Language

Added in API level 24
String getISO3Language ()

返回此语言环境语言的三字母缩写。 如果语言环境未指定语言,则返回空字符串。 否则,返回一个小写的ISO 639-2 / T语言代码。 ISO 639-2语言代码可以在ftp://dkuug.dk/i18n/iso-639-2.txt在线找到

Returns
String
Throws
MissingResourceException Throws MissingResourceException if the three-letter language abbreviation is not available for this locale.

getISO3Language

Added in API level 24
String getISO3Language (String localeID)

[icu]返回此语言环境语言的三字母缩写。 如果语言环境未指定语言,则返回空字符串。 否则,返回一个小写的ISO 639-2 / T语言代码。 ISO 639-2语言代码可以在ftp://dkuug.dk/i18n/iso-639-2.txt在线找到

Parameters
localeID String
Returns
String
Throws
MissingResourceException Throws MissingResourceException if the three-letter language abbreviation is not available for this locale.

getISOCountries

Added in API level 24
String[] getISOCountries ()

返回ISO 3166中定义的所有双字母国家代码的列表。可用于创建区域设置。

Returns
String[]

getISOLanguages

Added in API level 24
String[] getISOLanguages ()

返回ISO 639中定义的所有双字母语言代码的列表。可用于创建区域设置。 [注:ISO 639不是一个稳定的标准 - 一些语言的代码已经改变。 此函数返回的列表包括代码已更改的语言的新代码和旧代码。]

Returns
String[]

getKeywordValue

Added in API level 24
String getKeywordValue (String localeID, 
                String keywordName)

[icu]返回指定语言环境中关键字的值。 如果关键字未定义,则返回null。 区域设置名称不需要标准化。

Parameters
localeID String
keywordName String: name of the keyword whose value is desired. Case insensitive.
Returns
String String the value of the keyword as a string

getKeywordValue

Added in API level 24
String getKeywordValue (String keywordName)

[icu]返回此语言环境中关键字的值。 如果关键字未定义,则返回null。

Parameters
keywordName String: name of the keyword whose value is desired. Case insensitive.
Returns
String the value of the keyword, or null.

getKeywords

Added in API level 24
Iterator<String> getKeywords (String localeID)

[icu]返回指定区域设置的关键字迭代器。 如果没有关键字,则返回null。

Parameters
localeID String
Returns
Iterator<String> an iterator over the keywords in the specified locale, or null if there are no keywords.

getKeywords

Added in API level 24
Iterator<String> getKeywords ()

[icu]返回此语言环境的关键字迭代器。 如果没有关键字,则返回null。

Returns
Iterator<String> iterator over keywords, or null if there are no keywords.

getLanguage

Added in API level 24
String getLanguage (String localeID)

返回区域设置ID的语言代码,该代码可以是空字符串或小写的ISO 639代码。

Parameters
localeID String
Returns
String

也可以看看:

getLanguage

Added in API level 24
String getLanguage ()

返回此语言环境的语言代码,该代码将是空字符串或小写的ISO 639代码。

Returns
String

也可以看看:

getLineOrientation

Added in API level 24
String getLineOrientation ()

[icu]返回此语言环境的线条布局方向。 可能的值是“从左到右”,“从右到左”,“从上到下”或“从下到上”。

Returns
String The locale's layout orientation for lines.

getName

Added in API level 24
String getName ()

[icu]返回此语言环境的(标准化)全名。

Returns
String String the full name of the localeID

getName

Added in API level 24
String getName (String localeID)

[icu]返回指定语言环境的(标准化)全名。

Parameters
localeID String: the localeID as a string
Returns
String String the full name of the localeID

getScript

Added in API level 24
String getScript ()

返回此语言环境的脚本代码,可能是空字符串。

Returns
String

也可以看看:

getScript

Added in API level 24
String getScript (String localeID)

[icu]返回指定语言环境的脚本代码,可能是空字符串。

Parameters
localeID String
Returns
String

也可以看看:

getUnicodeLocaleAttributes

Added in API level 24
Set<String> getUnicodeLocaleAttributes ()

返回与此语言环境相关联的unicode语言环境属性集合,如果没有属性,则返回空集合。 返回的集合是不可修改的。

Returns
Set<String> The set of attributes.

getUnicodeLocaleKeys

Added in API level 24
Set<String> getUnicodeLocaleKeys ()

返回由此语言环境定义的Unicode区域设置键集合,如果此语言环境没有,则返回空集合。 返回的集合是不可变的。 键都是小写字母。

Returns
Set<String> The set of Unicode locale keys, or the empty set if this locale has no Unicode locale keywords.

getUnicodeLocaleType

Added in API level 24
String getUnicodeLocaleType (String key)

返回与此语言环境的指定Unicode区域设置键相关联的Unicode区域设置类型。 返回没有类型定义的键的空字符串。 如果未定义键,则返回null。 密钥不区分大小写。 密钥必须是两个字母数字字符([0-9a-zA-Z]),否则会引发IllegalArgumentException。

Parameters
key String: the Unicode locale key
Returns
String The Unicode locale type associated with the key, or null if the locale does not define the key.
Throws
IllegalArgumentException if the key is not well-formed
NullPointerException if key is null

getVariant

Added in API level 24
String getVariant ()

返回此语言环境的变体代码,可能是空字符串。

Returns
String

也可以看看:

getVariant

Added in API level 24
String getVariant (String localeID)

[icu]返回指定语言环境的变体代码,可能是空字符串。

Parameters
localeID String
Returns
String

也可以看看:

hashCode

Added in API level 24
int hashCode ()

返回hashCode。

Returns
int a hash code value for this object.

isRightToLeft

Added in API level 24
boolean isRightToLeft ()

[icu]返回此语言环境的脚本是否从右向左书写。 如果没有脚本子标签,则使用可能的脚本,请参阅addLikelySubtags(ULocale) 如果不知道可能的脚本,则返回false。

根据CLDR脚本元数据,脚本是从右到左的,该元数据与脚本的字母是否具有Bidi_Class = R或AL相对应。

“ar”和“en-Hebr”返回true,“zh”和“fa-Cyrl”返回false。

Returns
boolean true if the locale's script is written right-to-left

minimizeSubtags

Added in API level 24
ULocale minimizeSubtags (ULocale loc)

[icu]按照以下CLDR技术报告中描述的算法,最小化提供的区域设置标识的子标记:

http://www.unicode.org/reports/tr35/#Likely_Subtags
If the provided ULocale instance is already in the minimal form, or there is no data available for minimization, it will be returned. Since the minimization algorithm relies on proper maximization, see the comments for addLikelySubtags for reasons why there might not be any data. Examples:

 "en_Latn_US" minimizes to "en"

 "de_Latn_US" minimizes to "de"

 "sr_Cyrl_RS" minimizes to "sr"

 "zh_Hant_TW" minimizes to "zh_TW" (The region is preferred to the
 script, and minimizing to "zh" would imply "zh_Hans_CN".) 

Parameters
loc ULocale: The ULocale to minimize
Returns
ULocale The minimized ULocale instance.

setKeywordValue

Added in API level 24
ULocale setKeywordValue (String keyword, 
                String value)

[icu]给定一个关键字和一个值,返回一个新的语言环境,其中包含一个更新后的关键字和值。 如果关键字为空,则会从区域设置ID中删除所有关键字。 否则,如果值为null,则会从区域设置ID中删除此关键字的值。 否则,这会在区域设置ID中添加/替换此关键字的值。 关键字和值不能为空。

相关: getBaseName()返回删除所有关键字的区域设置ID字符串。

Parameters
keyword String: the keyword to add/remove, or null to remove all keywords.
value String: the value to add/set, or null to remove this particular keyword.
Returns
ULocale the updated locale

setKeywordValue

Added in API level 24
String setKeywordValue (String localeID, 
                String keyword, 
                String value)

给定一个语言环境ID,一个关键字和一个值,返回一个新的语言环境ID与更新的关键字和值。 如果关键字为空,则会从区域设置ID中删除所有关键字。 否则,如果值为null,则会从区域设置ID中删除此关键字的值。 否则,这会在区域设置ID中添加/替换此关键字的值。 关键字和值不能为空。

相关: getBaseName(String)返回删除所有关键字的区域设置ID字符串。

Parameters
localeID String: the locale id to modify
keyword String: the keyword to add/remove, or null to remove all keywords.
value String: the value to add/set, or null to remove this particular keyword.
Returns
String the updated locale id

toLanguageTag

Added in API level 24
String toLanguageTag ()

返回表示此语言环境的格式良好的IETF BCP 47语言标记。

如果此 ULocale具有不符合IETF BCP 47语言标记语法要求的语言,脚本,国家或变体,则此方法按如下所述处理这些字段:

语言:如果语言为空或者格式不正确(例如“a”或“e2”),它将以“und”(未确定)形式发布。

脚本:如果脚本格式不正确(例如“12”或“拉丁”),它将被忽略。

国家:如果国家不健全(例如“12”或“美国”),它将被省略。

变体:如果公形成变型,每个子段(由分隔“ - ”或“_”)的光作为一个子标记。 除此以外:

  • if all sub-segments match [0-9a-zA-Z]{1,8} (for example "WIN" or "Oracle_JDK_Standard_Edition"), the first ill-formed sub-segment and all following will be appended to the private use subtag. The first appended subtag will be "lvariant", followed by the sub-segments in order, separated by hyphen. For example, "x-lvariant-WIN", "Oracle-x-lvariant-JDK-Standard-Edition".
  • if any sub-segment does not match [0-9a-zA-Z]{1,8}, the variant will be truncated and the problematic sub-segment and all following sub-segments will be omitted. If the remainder is non-empty, it will be emitted as a private use subtag as above (even if the remainder turns out to be well-formed). For example, "Solaris_isjustthecoolestthing" is emitted as "x-lvariant-Solaris", not as "solaris".

注意:尽管此方法创建的语言标记格式良好(满足IETF BCP 47规范定义的语法要求),但它不一定是有效的BCP 47语言标记。 例如,

   new Locale("xx", "YY").toLanguageTag();
will return "xx-YY", but the language subtag "xx" and the region subtag "YY" are invalid because they are not registered in the IANA Language Subtag Registry.

Returns
String a BCP47 language tag representing the locale

也可以看看:

toLegacyKey

Added in API level 24
String toLegacyKey (String keyword)

[icu]将指定的关键字(BCP 47 Unicode区域设置扩展密钥或旧密钥)转换为旧密钥。 例如,为输入的BCP 47 Unicode区域设置扩展密钥“co”返回传统密钥“排序规则”。

Parameters
keyword String: the input locale keyword (either BCP 47 Unicode locale extension key or legacy key).
Returns
String the well-formed legacy key, or null if the specified keyword cannot be mapped to a well-formed legacy key.

也可以看看:

toLegacyType

Added in API level 24
String toLegacyType (String keyword, 
                String value)

[icu]将指定的关键字值(BCP 47 Unicode区域设置扩展类型或旧式类型或类型别名)转换为规范旧式类型。 例如,使用关键字“整理”(或“co”)为输入的BCP 47 Unicode区域设置扩展类型“phonebk”返回传统类型“电话簿”。

如果指定的关键字未被识别,但指定的值满足旧密钥的语法,或者当指定的关键字允许“可变”类型并且指定的值符合语法时,则会返回输入值的小写版本。 例如, toLegacyType("Foo", "Bar")返回“bar”, toLegacyType("vt", "00A4")返回“00a4”。

Parameters
keyword String: the locale keyword (either legacy keyword such as "collation" or BCP 47 Unicode locale extension key such as "co").
value String: the locale keyword value (either BCP 47 Unicode locale extension type such as "phonebk" or legacy keyword value such as "phonebook").
Returns
String the well-formed legacy type, or null if the specified keyword value cannot be mapped to a well-formed legacy type.

也可以看看:

toLocale

Added in API level 24
Locale toLocale ()

[icu]将此ULocale对象转换为 Locale

Returns
Locale a Locale that either exactly represents this object or is the closest approximation.

toString

Added in API level 24
String toString ()

返回此对象的字符串表示形式。

Returns
String a string representation of the object.

toUnicodeLocaleKey

Added in API level 24
String toUnicodeLocaleKey (String keyword)

[icu]将指定关键字(传统密钥或BCP 47 Unicode区域设置扩展密钥)转换为等效的BCP 47 Unicode区域设置扩展密钥。 例如,为输入关键字“归类”返回BCP 47 Unicode区域设置扩展键“co”。

如果指定的关键字未知,但满足BCP语法,则将返回输入关键字的小写版本。 例如, toUnicodeLocaleKey("ZZ")返回“zz”。

Parameters
keyword String: the input locale keyword (either legacy key such as "collation" or BCP 47 Unicode locale extension key such as "co").
Returns
String the well-formed BCP 47 Unicode locale extension key, or null if the specified locale keyword cannot be mapped to a well-formed BCP 47 Unicode locale extension key.

也可以看看:

toUnicodeLocaleType

Added in API level 24
String toUnicodeLocaleType (String keyword, 
                String value)

[icu]将指定的关键字值(传统类型或BCP 47 Unicode区域设置扩展类型)转换为指定关键字(类别)格式良好的BCP 47 Unicode区域设置扩展类型。 例如,使用关键字“整理”(或“co”)为输入关键字值“phonebook”返回BCP 47 Unicode区域设置扩展类型“phonebk”。

如果指定的关键字未被识别,但指定的值满足BCP 47 Unicode区域设置扩展类型的语法,或者指定的关键字允许“变量”类型且指定的值满足语法,则输入的小写版本值将被返回。 例如, toUnicodeLocaleType("Foo", "Bar")返回“bar”, toUnicodeLocaleType("variableTop", "00A4")返回“00a4”。

Parameters
keyword String: the locale keyword (either legacy key such as "collation" or BCP 47 Unicode locale extension key such as "co").
value String: the locale keyword value (either legacy type such as "phonebook" or BCP 47 Unicode locale extension type such as "phonebk").
Returns
String the well-formed BCP47 Unicode locale extension type, or null if the locale keyword value cannot be mapped to a well-formed BCP 47 Unicode locale extension type.

也可以看看:

Hooray!