Locale

PRIVATE_USE_EXTENSION

char PRIVATE_USE_EXTENSION

私人用途扩展的关键（'x'）。

常量值：120（0x00000078）

UNICODE_LOCALE_EXTENSION

char UNICODE_LOCALE_EXTENSION

Unicode区域扩展的关键（'u'）。

常量值：117（0x00000075）

CANADA

Locale CANADA

国家有用的常数。

CANADA_FRENCH

Locale CANADA_FRENCH

国家有用的常数。

CHINA

Locale CHINA

国家有用的常数。

CHINESE

Locale CHINESE

有用的语言常数。

ENGLISH

Locale ENGLISH

有用的语言常数。

FRANCE

Locale FRANCE

国家有用的常数。

FRENCH

Locale FRENCH

有用的语言常数。

GERMAN

Locale GERMAN

有用的语言常数。

GERMANY

Locale GERMANY

国家有用的常数。

ITALIAN

Locale ITALIAN

有用的语言常数。

ITALY

Locale ITALY

国家有用的常数。

JAPAN

Locale JAPAN

国家有用的常数。

JAPANESE

Locale JAPANESE

有用的语言常数。

KOREA

Locale KOREA

国家有用的常数。

KOREAN

Locale KOREAN

有用的语言常数。

PRC

Locale PRC

国家有用的常数。

ROOT

Locale ROOT

根区域设置的有用常量。 根区域设置是其语言，国家和变体为空（“”）字符串的区域设置。 这被认为是所有语言环境的基本语言环境，并被用作区域敏感操作的语言/国家中性语言环境。

SIMPLIFIED_CHINESE

Locale SIMPLIFIED_CHINESE

有用的语言常数。

TAIWAN

Locale TAIWAN

国家有用的常数。

TRADITIONAL_CHINESE

Locale TRADITIONAL_CHINESE

有用的语言常数。

UK

Locale UK

国家有用的常数。

US

Locale US

国家有用的常数。

Locale

Locale (String language, 
                String country, 
                String variant)

从语言，国家和变体构建语言环境。 此构造函数将语言值标准化为小写，将国家/地区值标准化为大写。

注意：

• ISO 639 is not a stable standard; some of the language codes it defines (specifically "iw", "ji", and "in") have changed. This constructor accepts both the old codes ("iw", "ji", and "in") and the new codes ("he", "yi", and "id"), but all other API on Locale will return only the OLD codes.
• For backward compatibility reasons, this constructor does not make any syntactic checks on the input.
• The two cases ("ja", "JP", "JP") and ("th", "TH", "TH") are handled specially, see Special Cases for more information.

Locale

Locale (String language, 
                String country)

从语言和国家构建语言环境。 此构造函数将语言值标准化为小写，将国家/地区值标准化为大写。

注意：

• ISO 639 is not a stable standard; some of the language codes it defines (specifically "iw", "ji", and "in") have changed. This constructor accepts both the old codes ("iw", "ji", and "in") and the new codes ("he", "yi", and "id"), but all other API on Locale will return only the OLD codes.
• For backward compatibility reasons, this constructor does not make any syntactic checks on the input.

Locale

Locale (String language)

从语言代码构建语言环境。 此构造函数将语言值标准化为小写。

Note:

• ISO 639 is not a stable standard; some of the language codes it defines (specifically "iw", "ji", and "in") have changed. This constructor accepts both the old codes ("iw", "ji", and "in") and the new codes ("he", "yi", and "id"), but all other API on Locale will return only the OLD codes.
• For backward compatibility reasons, this constructor does not make any syntactic checks on the input.

clone

Object clone ()

覆盖可复制。

equals

boolean equals (Object obj)

如果此Locale等于另一个对象，则返回true。 一个语言环境被认为与另一个具有相同语言，脚本，国家，变体和扩展名的语言环境相同，并且与所有其他对象不相等。

forLanguageTag

Locale forLanguageTag (String languageTag)

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

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

执行以下 转换 ：

• The language code "und" is mapped to language "".
• The language codes "he", "yi", and "id" are mapped to "iw", "ji", and "in" respectively. (This is the same canonicalization that's done in Locale's constructors.)
• 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:

       Locale loc;
       loc = Locale.forLanguageTag("en-US-x-lvariant-POSIX");
       loc.getVariant(); // returns "POSIX"
       loc.getExtension('x'); // returns null
  
       loc = Locale.forLanguageTag("de-POSIX-x-URP-lvariant-Abc-Def");
       loc.getVariant(); // returns "POSIX_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:

       Locale.forLanguageTag("ar-aao").getLanguage(); // returns "aao"
       Locale.forLanguageTag("en-abc-def-us").toString(); // returns "abc_US"
   

• Case is normalized except for variant tags, which are left unchanged. Language is normalized to lower case, script to title case, country to upper case, and extensions to lower case.
• If, after processing, the locale would exactly match either ja_JP_JP or th_TH_TH with no extensions, the appropriate extensions are added as though the constructor had been called:

      Locale.forLanguageTag("ja-JP-x-lvariant-JP").toLanguageTag();
      // returns "ja-JP-u-ca-japanese-x-lvariant-JP"
      Locale.forLanguageTag("th-TH-x-lvariant-TH").toLanguageTag();
      // returns "th-TH-u-nu-thai-x-lvariant-TH"
   
  

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

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

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

有关所有祖父标记的列表，请参阅IANA语言标签注册表（搜索“类型：祖父”）。

注意 ：不能保证 toLanguageTag和 forLanguageTag会往返。

getAvailableLocales

Locale[] getAvailableLocales ()

返回所有已安装语言环境的数组。 返回的数组表示Java运行时环境支持的语言环境的联合以及安装的LocaleServiceProvider实现。 它必须包含至少一个等于Locale.US的Locale实例。

getCountry

String getCountry ()

返回此语言环境的国家/地区代码，该代码应该是空字符串，大写ISO 3166 2字母代码或UN M.49 3位代码。

getDefault

Locale getDefault (Locale.Category category)

获取Java虚拟机的此实例的指定类别的默认语言环境的当前值。

Java虚拟机根据主机环境设置启动期间的默认区域设置。 如果没有明确指定区域设置，它会被许多区域敏感的方法使用。 它可以使用setDefault（Locale.Category，Locale）方法进行更改。

getDefault

Locale getDefault ()

获取此Java虚拟机实例的默认语言环境的当前值。

Java虚拟机根据主机环境设置启动期间的默认区域设置。 如果没有明确指定区域设置，它会被许多区域敏感的方法使用。 可以使用setDefault方法更改它。

getDisplayCountry

String getDisplayCountry (Locale locale)

返回此语言环境国家的名称，本地化为locale 。 如果此语言环境不符合特定国家/地区，则返回空字符串。

getDisplayCountry

String getDisplayCountry ()

返回适合显示给用户的语言环境国家的名称。 如果可能，返回的名称将被本地化为默认语言环境。 例如，如果区域设置为fr_FR且默认区域设置为en_US，则getDisplayCountry（）将返回“France”; 如果区域设置为en_US且默认区域设置为fr_FR，则getDisplayCountry（）将返回“Etats-Unis”。 如果返回的名称不能在默认语言环境中进行本地化（例如，我们没有克罗地亚语的日语名称），则此功能将返回英文名称，并将ISO代码作为最后的度假值。 如果区域设置未指定国家/地区，则此函数返回空字符串。

getDisplayLanguage

String getDisplayLanguage (Locale locale)

返回此语言环境的语言名称，本地化为locale 。 如果语言名称未知，则返回语言代码。

getDisplayLanguage

String getDisplayLanguage ()

返回适合显示给用户的语言环境语言的名称。 如果可能，返回的名称将被本地化为默认语言环境。 例如，如果区域设置为fr_FR且默认区域设置为en_US，则getDisplayLanguage（）将返回“French”; 如果区域设置为en_US且默认区域设置为fr_FR，则getDisplayLanguage（）将返回“anglais”。 如果返回的名称不能用于默认语言环境（例如，我们没有克罗地亚语的日语名称），则此函数将回退英文名称，并使用ISO代码作为最后的度假值。 如果区域设置未指定语言，则此函数返回空字符串。

getDisplayName

String getDisplayName ()

返回适合显示给用户的语言环境的名称。 这将是由getDisplayLanguage（），getDisplayScript（），getDisplayCountry（）和getDisplayVariant（）组合成单个字符串所返回的值。 非空值按顺序使用，第二个和后续名称用括号括起来。 例如：

language (script, country, variant)
language (country)
language (variant)
script (country)
country

getDisplayName

String getDisplayName (Locale locale)

返回本地化的语言名称，国家名称和变体，本地化为locale 。 确切的输出形式取决于该语言环境是否对应于特定语言，脚本，国家和变体。

For example:

• new Locale("en").getDisplayName(Locale.US) -> English
• new Locale("en", "US").getDisplayName(Locale.US) -> English (United States)
• new Locale("en", "US", "POSIX").getDisplayName(Locale.US) -> English (United States,Computer)
• Locale.fromLanguageTag("zh-Hant-CN").getDisplayName(Locale.US) -> Chinese (Traditional Han,China)
• new Locale("en").getDisplayName(Locale.FRANCE) -> anglais
• new Locale("en", "US").getDisplayName(Locale.FRANCE) -> anglais (États-Unis)
• new Locale("en", "US", "POSIX").getDisplayName(Locale.FRANCE) -> anglais (États-Unis,informatique).

getDisplayScript

String getDisplayScript ()

返回适合显示给用户的区域设置脚本的名称。 如果可能的话，该名称将针对默认语言环境进行本地化。 如果此语言环境未指定脚本代码，则返回空字符串。

getDisplayScript

String getDisplayScript (Locale locale)

返回此语言环境的脚本代码的名称，本地化为Locale 。 如果脚本代码未知，则此方法的返回值与getScript()相同。

getDisplayVariant

String getDisplayVariant (Locale locale)

返回指定的全异名Locale本的变种代码Locale 。 如果没有匹配的变体名称，则返回变体代码。

getDisplayVariant

String getDisplayVariant ()

返回适合向用户显示的区域设置的变体代码的名称。 如果可能的话，该名称将针对默认语言环境进行本地化。 如果区域设置未指定变体代码，则此函数返回空字符串。

getExtension

String getExtension (char key)

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

getExtensionKeys

Set<Character> getExtensionKeys ()

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

getISO3Country

String getISO3Country ()

返回此语言环境国家的三字母缩写。 如果国家符合ISO 3166-1 alpha-2代码，则返回相应的ISO 3166-1 alpha-3大写代码。 如果语言环境未指定国家/地区，则这将是空字符串。

ISO 3166-1编码可以在线找到。

getISO3Language

String getISO3Language ()

返回此语言环境语言的三字母缩写。 如果语言符合ISO 639-1两字母代码，则返回相应的ISO 639-2 / T三字母小写代码。 ISO 639-2语言代码可在线找到，请参阅“语言名称表示法代码第2部分：Alpha-3代码”。 如果语言环境指定了三字母语言，则语言按原样返回。 如果语言环境未指定语言，则返回空字符串。

getISOCountries

String[] getISOCountries ()

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

注意： Locale类还支持国家（地区）的其他代码，例如3个字母的数字UN M.49区号。 因此，此方法返回的列表不包含可用于创建区域设置的所有有效代码。

getISOLanguages

String[] getISOLanguages ()

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

注意：

• ISO 639 is not a stable standard— some languages' codes have changed. The list this function returns includes both the new and the old codes for the languages whose codes have changed.
• The Locale class also supports language codes up to 8 characters in length. Therefore, the list returned by this method does not contain ALL valid codes that can be used to create Locales.

getLanguage

String getLanguage ()

返回此Locale的语言代码。

注意： ISO 639不是一个稳定的标准 - 某些语言的代码已经改变。 语言环境的构造函数识别代码已更改的语言的新代码和旧代码，但此函数始终返回旧代码。 如果您想检查代码已更改的特定语言，请不要这样做

 if (locale.getLanguage().equals("he")) // BAD!
    ...
 

 if (locale.getLanguage().equals(new Locale("he").getLanguage()))
    ...
 

getScript

String getScript ()

返回此语言环境的脚本，它应该是空字符串或ISO 15924 4字母脚本代码。 第一个字母是大写字母，其余的都是小写字母，例如'Latn'，'Cyrl'。

getUnicodeLocaleAttributes

Set<String> getUnicodeLocaleAttributes ()

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

getUnicodeLocaleKeys

Set<String> getUnicodeLocaleKeys ()

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

getUnicodeLocaleType

String getUnicodeLocaleType (String key)

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

getVariant

String getVariant ()

返回此语言环境的变体代码。

hashCode

int hashCode ()

覆盖hashCode。 由于经常在散列表中使用区域设置，因此缓存速度值。

setDefault

void setDefault (Locale newLocale)

设置此Java虚拟机实例的默认语言环境。 这不会影响主机区域设置。

如果有安全管理器，则在更改默认语言环境之前，将调用其 checkPermission方法，并具有 PropertyPermission("user.language", "write")权限。

Java虚拟机根据主机环境设置启动期间的默认区域设置。 如果没有明确指定区域设置，它会被许多区域敏感的方法使用。

由于更改默认语言环境可能会影响许多不同的功能区域，因此只能在调用者准备重新初始化在同一Java虚拟机内运行的区域敏感代码时使用此方法。

通过使用此方法设置默认语言环境，每个类别的所有默认语言环境也都设置为指定的默认语言环境。

setDefault

void setDefault (Locale.Category category, 
                Locale newLocale)

为Java虚拟机的此实例设置指定类别的默认语言环境。 这不会影响主机区域设置。

如果存在安全管理器，则在更改默认语言环境之前，会使用PropertyPermission（“user.language”，“write”）权限调用checkPermission方法。

Java虚拟机根据主机环境设置启动期间的默认区域设置。 如果没有明确指定区域设置，它会被许多区域敏感的方法使用。

由于更改默认语言环境可能会影响许多不同的功能区域，因此只能在调用者准备重新初始化在同一Java虚拟机内运行的区域敏感代码时使用此方法。

toLanguageTag

String toLanguageTag ()

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

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

语言：如果语言为空，或不是 well-formed （例如“a”或“e2”），它将以“und”（未确定）排出。

国家/地区：如果国家 /地区不是 well-formed （例如“12”或“USA”），则将被省略。

变体：如果变体是 well-formed ，则每个子片段（由' - '或'_'分隔）都作为子标签发出。 除此以外：

• 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".

特殊转换：为了兼容性，Java支持一些旧的区域表示，包括不赞成使用的ISO语言代码。 此方法执行以下转换：

• Deprecated ISO language codes "iw", "ji", and "in" are converted to "he", "yi", and "id", respectively.
• A locale with language "no", country "NO", and variant "NY", representing Norwegian Nynorsk (Norway), is converted to a language tag "nn-NO".

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

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

toString

String toString ()

返回此 Locale对象的字符串表示形式，包括语言，国家，变体，脚本和扩展名，如下所示：

language + "_" + country + "_" + (variant + "_#" | "#") + script + "-" + extensions

当语言环境既没有脚本也没有扩展时，结果与Java 6及之前的版本相同。

如果缺少语言和国家/地区字段，即使存在变体，脚本或扩展字段（该字段不能包含只有变体的区域设置，该变体必须伴随着一个知名的字符）形成的语言或国家代码）。

如果脚本或扩展名存在且变体丢失，则在“＃”之前不加下划线。

此行为旨在支持调试，并与toString预期语言，国家和变体字段的以前使用的toString兼容。 要将交换目的的语言环境表示为字符串，请使用toLanguageTag() 。

Examples:

• en
• de_DE
• _GB
• en_US_WIN
• de__POSIX
• zh_CN_#Hans
• zh_TW_#Hant-x-java
• th_TH_TH_#u-nu-thai