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如下:
canonicalize
can be called to convert the id to canonical form, or the
canonicalInstance
factory method can be called.
注意: 实际的语言环境会正确返回,但在大多数情况下, 有效的语言环境不是。
也可以看看:
Nested classes |
|
---|---|
class |
ULocale.Builder |
枚举 |
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对象 |
static ULocale[] |
getAvailableLocales() [icu]注意:与Locale API不同,这将返回 |
String |
getBaseName() [icu]返回此语言环境的(标准化)基本名称,如 |
static String |
getBaseName(String localeID) [icu]返回指定语言环境的(标准化)基本名称,如 |
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() 返回本地化的国家/地区,以默认 |
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]返回一个关键字,用于在默认的 |
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]返回一个关键字值,以默认的 |
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() 返回本地化的语言,以默认的 |
String |
getDisplayLanguageWithDialect(ULocale displayLocale) [icu]返回本地化的语言,用于在提供的语言环境中显示。 |
static String |
getDisplayLanguageWithDialect(String localeID, String displayLocaleID) [icu]返回本地化的语言,用于在提供的语言环境中显示。 |
static String |
getDisplayLanguageWithDialect(String localeID, ULocale displayLocale) [icu]返回本地化的语言,用于在提供的语言环境中显示。 |
String |
getDisplayLanguageWithDialect() [icu]返回本地化的语言,以默认的 |
String |
getDisplayName() 返回此语言环境名称,以便在默认的 |
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]返回本地化名称,以便在默认的 |
static String |
getDisplayScript(String localeID, String displayLocaleID) [icu]返回本地化的脚本,用于在提供的语言环境中显示。 |
static String |
getDisplayScript(String localeID, ULocale displayLocale) [icu]返回本地化的脚本,用于在提供的语言环境中显示。 |
String |
getDisplayScript() 返回本地化的脚本,用于在默认的 |
String |
getDisplayScript(ULocale displayLocale) 返回本地化的脚本,用于在提供的语言环境中显示。 |
static String |
getDisplayVariant(String localeID, String displayLocaleID) [icu]返回本地化的变体,用于在提供的语言环境中显示。 |
String |
getDisplayVariant() 返回此语言环境的本地化版本,以默认的 |
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_SubtagsIf 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对象转换为 |
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
|
char PRIVATE_USE_EXTENSION
私人使用区域设置扩展('x')的关键。
常量值:120(0x00000078)
char UNICODE_LOCALE_EXTENSION
Unicode区域扩展的关键('u')。
常量值:117(0x00000075)
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 (String a, String b)
为了与java.util.Locale兼容,ULocale(String,String,String)方便的重载。
Parameters | |
---|---|
a |
String
|
b |
String
|
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 |
也可以看看:
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 |
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 |
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 |
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 |
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. |
String canonicalize (String localeID)
[icu]返回指定区域设置标识的规范名称。 这用于将POSIX和其他老式ID转换为标准ICU形式。
Parameters | |
---|---|
localeID |
String : the locale id |
Returns | |
---|---|
String |
the canonicalized id |
Object clone ()
这是为了兼容Locale--实际上,因为ULocale是不可变的,所以没有理由克隆它,所以这个API返回'this'。
Returns | |
---|---|
Object |
a clone of this instance. |
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. |
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. |
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. |
ULocale forLanguageTag (String languageTag)
返回指定的IETF BCP 47语言标记字符串的语言环境。
如果指定的语言标签包含任何不合格的子标签,则会忽略第一个此类子标签和所有后续子标签。 与在这种情况下抛出异常的setLanguageTag(String)
相比较。
执行以下 转换 :
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"
ULocale.forLanguageTag("ar-aao").getLanguage(); // returns "aao" ULocale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"
这实现了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语言标签注册表(搜索“类型:祖父”)。
注意 : toLanguageTag
和 forLanguageTag
不能保证往返。
Parameters | |
---|---|
languageTag |
String : the language tag |
Returns | |
---|---|
ULocale |
The locale that best represents the language tag. |
Throws | |
---|---|
NullPointerException |
if languageTag is null |
ULocale forLocale (Locale loc)
[ICU]返回给一个ULocale对象Locale
。 ULocale是规范化的。
Parameters | |
---|---|
loc |
Locale : a Locale |
Returns | |
---|---|
ULocale |
ULocale[] getAvailableLocales ()
[icu]注意:与Locale API不同,这将返回ULocale
的数组,而不是Locale
。 返回所有已安装语言环境的列表。
Returns | |
---|---|
ULocale[] |
String getBaseName ()
[icu]返回此语言环境的(标准化)基本名称,如 getName()
,但没有关键字。
Returns | |
---|---|
String |
the base name as a String. |
String getBaseName (String localeID)
[icu]返回指定语言环境的(标准化)基本名称,如 getName(String)
,但不包含关键字。
Parameters | |
---|---|
localeID |
String : the locale ID as a string |
Returns | |
---|---|
String |
the base name as a String. |
String getCharacterOrientation ()
[icu]返回此语言环境的字符布局方向。 可能的值是“从左到右”,“从右到左”,“从上到下”或“从下到上”。
Returns | |
---|---|
String |
The locale's layout orientation for characters. |
String getCountry (String localeID)
[icu]返回此语言环境的国家/地区代码,该代码可以是空字符串,也可以是大写的ISO 3166 2字母代码。
Parameters | |
---|---|
localeID |
String : The locale identification string. |
Returns | |
---|---|
String |
String getCountry ()
返回此语言环境的国家/地区代码,该代码可以是空字符串,也可以是大写的ISO 3166 2字母代码。
Returns | |
---|---|
String |
ULocale getDefault ()
返回当前的默认ULocale。
默认的ULocale被同步到默认的Java语言环境。 此方法检查当前的默认Java语言环境并返回等效的ULocale。
Returns | |
---|---|
ULocale |
the default ULocale. |
ULocale getDefault (ULocale.Category category)
返回指定类别的当前默认ULocale。
Parameters | |
---|---|
category |
ULocale.Category : the category |
Returns | |
---|---|
ULocale |
the default ULocale for the specified category. |
String getDisplayCountry ()
返回本地化的国家/地区,以默认DISPLAY
区域设置显示。 警告:这是区域有效区域设置ID的一部分; 它不能只是区域代码(如“FR”)。 要获取单独区域或其他选项的显示名称, LocaleDisplayNames
改为使用LocaleDisplayNames
。
Returns | |
---|---|
String |
the localized country name. |
也可以看看:
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. |
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. |
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. |
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. |
也可以看看:
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. |
也可以看看:
String getDisplayKeyword (String keyword)
[icu]返回一个关键字,用于在默认 DISPLAY
区域设置中显示。
Parameters | |
---|---|
keyword |
String : the keyword to be displayed. |
Returns | |
---|---|
String |
the localized keyword name. |
也可以看看:
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. |
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. |
String getDisplayKeywordValue (String keyword)
[icu]返回本地化的关键字值,以默认的 DISPLAY
语言环境显示。
Parameters | |
---|---|
keyword |
String : the keyword whose value is to be displayed. |
Returns | |
---|---|
String |
the localized value name. |
也可以看看:
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. |
String getDisplayLanguage (ULocale displayLocale)
返回本地化的语言,用于在提供的语言环境中显示。
Parameters | |
---|---|
displayLocale |
ULocale : the locale in which to display the name. |
Returns | |
---|---|
String |
the localized language name. |
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. |
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. |
String getDisplayLanguage ()
返回本地化的语言,以默认的 DISPLAY
语言环境显示。
Returns | |
---|---|
String |
the localized language name. |
也可以看看:
String getDisplayLanguageWithDialect (ULocale displayLocale)
[icu]返回本地化的语言,用于在提供的语言环境中显示。 如果数据中存在方言名称,则返回。
Parameters | |
---|---|
displayLocale |
ULocale : the locale in which to display the name. |
Returns | |
---|---|
String |
the localized language name. |
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. |
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. |
String getDisplayLanguageWithDialect ()
[icu]返回本地化的语言,以默认的DISPLAY
语言环境显示。 如果数据中存在方言名称,则返回。
Returns | |
---|---|
String |
the localized language name. |
也可以看看:
String getDisplayName ()
返回本地化名称,以便在默认的 DISPLAY
语言环境中显示。
Returns | |
---|---|
String |
the localized locale name. |
也可以看看:
String getDisplayName (ULocale displayLocale)
返回本地化名称,用于在提供的语言环境中显示。
Parameters | |
---|---|
displayLocale |
ULocale : the locale in which to display the locale name. |
Returns | |
---|---|
String |
the localized locale name. |
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. |
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. |
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. |
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. |
String getDisplayNameWithDialect (ULocale displayLocale)
[icu]返回本地化名称,用于在提供的语言环境中显示。 如果区域设置数据中存在方言名称,则返回该方言名称。
Parameters | |
---|---|
displayLocale |
ULocale : the locale in which to display the locale name. |
Returns | |
---|---|
String |
the localized locale name. |
String getDisplayNameWithDialect ()
[icu]返回本地化名称,以便在默认的DISPLAY
语言环境中显示。 如果区域设置数据中存在方言名称,则返回该方言名称。
Returns | |
---|---|
String |
the localized locale name. |
也可以看看:
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. |
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. |
String getDisplayScript ()
返回本地化的脚本,以便在默认的 DISPLAY
语言环境中显示。
Returns | |
---|---|
String |
the localized script name. |
也可以看看:
String getDisplayScript (ULocale displayLocale)
返回本地化的脚本,用于在提供的语言环境中显示。
Parameters | |
---|---|
displayLocale |
ULocale : the locale in which to display the name. |
Returns | |
---|---|
String |
the localized script name. |
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. |
String getDisplayVariant ()
返回此语言环境的本地化版本,以默认的 DISPLAY
语言环境显示。
Returns | |
---|---|
String |
the localized variant name. |
也可以看看:
String getDisplayVariant (ULocale displayLocale)
返回本地化的变体,用于在提供的区域中显示。
Parameters | |
---|---|
displayLocale |
ULocale : the locale in which to display the name. |
Returns | |
---|---|
String |
the localized variant name. |
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. |
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 |
Set<Character> getExtensionKeys ()
返回与此语言环境相关联的扩展键集合,如果没有扩展名,则返回空集合。 返回的集合是不可修改的。 钥匙都是小写的。
Returns | |
---|---|
Set<Character> |
the set of extension keys, or the empty set if this locale has no extensions |
ULocale getFallback ()
[icu]返回此语言环境的回退语言环境。 如果此区域设置为root,则返回null。
Returns | |
---|---|
ULocale |
String getFallback (String localeID)
[icu]返回指定语言环境的回退语言环境,该语言环境可能是空字符串。
Parameters | |
---|---|
localeID |
String
|
Returns | |
---|---|
String |
String getISO3Country ()
返回此区域设置的国家/地区的三字母缩写。 如果区域设置未指定国家,则返回空字符串。 否则,返回一个大写的ISO 3166 3个字母的国家代码。
Returns | |
---|---|
String |
Throws | |
---|---|
MissingResourceException |
Throws MissingResourceException if the three-letter country abbreviation is not available for this locale. |
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. |
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. |
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. |
String[] getISOCountries ()
返回ISO 3166中定义的所有双字母国家代码的列表。可用于创建区域设置。
Returns | |
---|---|
String[] |
String[] getISOLanguages ()
返回ISO 639中定义的所有双字母语言代码的列表。可用于创建区域设置。 [注:ISO 639不是一个稳定的标准 - 一些语言的代码已经改变。 此函数返回的列表包括代码已更改的语言的新代码和旧代码。]
Returns | |
---|---|
String[] |
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 |
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. |
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. |
Iterator<String> getKeywords ()
[icu]返回此语言环境的关键字迭代器。 如果没有关键字,则返回null。
Returns | |
---|---|
Iterator<String> |
iterator over keywords, or null if there are no keywords. |
String getLanguage (String localeID)
返回区域设置ID的语言代码,该代码可以是空字符串或小写的ISO 639代码。
Parameters | |
---|---|
localeID |
String
|
Returns | |
---|---|
String |
String getLanguage ()
返回此语言环境的语言代码,该代码将是空字符串或小写的ISO 639代码。
Returns | |
---|---|
String |
String getLineOrientation ()
[icu]返回此语言环境的线条布局方向。 可能的值是“从左到右”,“从右到左”,“从上到下”或“从下到上”。
Returns | |
---|---|
String |
The locale's layout orientation for lines. |
String getName ()
[icu]返回此语言环境的(标准化)全名。
Returns | |
---|---|
String |
String the full name of the localeID |
String getName (String localeID)
[icu]返回指定语言环境的(标准化)全名。
Parameters | |
---|---|
localeID |
String : the localeID as a string |
Returns | |
---|---|
String |
String the full name of the localeID |
String getScript (String localeID)
[icu]返回指定语言环境的脚本代码,可能是空字符串。
Parameters | |
---|---|
localeID |
String
|
Returns | |
---|---|
String |
Set<String> getUnicodeLocaleAttributes ()
返回与此语言环境相关联的unicode语言环境属性集合,如果没有属性,则返回空集合。 返回的集合是不可修改的。
Returns | |
---|---|
Set<String> |
The set of attributes. |
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. |
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 |
String getVariant (String localeID)
[icu]返回指定语言环境的变体代码,可能是空字符串。
Parameters | |
---|---|
localeID |
String
|
Returns | |
---|---|
String |
int hashCode ()
返回hashCode。
Returns | |
---|---|
int |
a hash code value for this object. |
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 |
ULocale minimizeSubtags (ULocale loc)
[icu]按照以下CLDR技术报告中描述的算法,最小化提供的区域设置标识的子标记:
http://www.unicode.org/reports/tr35/#Likely_SubtagsIf 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. |
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 |
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 |
String toLanguageTag ()
返回表示此语言环境的格式良好的IETF BCP 47语言标记。
如果此 ULocale
具有不符合IETF BCP 47语言标记语法要求的语言,脚本,国家或变体,则此方法按如下所述处理这些字段:
语言:如果语言为空或者格式不正确(例如“a”或“e2”),它将以“und”(未确定)形式发布。
脚本:如果脚本格式不正确(例如“12”或“拉丁”),它将被忽略。
国家:如果国家不健全(例如“12”或“美国”),它将被省略。
变体:如果是公形成变型,每个子段(由分隔“ - ”或“_”)的光作为一个子标记。 除此以外:
[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". [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 |
也可以看看:
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. |
也可以看看:
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. |
Locale toLocale ()
[icu]将此ULocale对象转换为 Locale
。
Returns | |
---|---|
Locale |
a Locale that either exactly represents this object or is the closest approximation. |
String toString ()
返回此对象的字符串表示形式。
Returns | |
---|---|
String |
a string representation of the object. |
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. |
也可以看看:
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. |
也可以看看: