Locale 类

定义

[Android.Runtime.Register("java/util/Locale", DoNotGenerateAcw=true)]
public sealed class Locale : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICloneable

[<Android.Runtime.Register("java/util/Locale", DoNotGenerateAcw=true)>]
type Locale = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable

继承

Object

Object

Locale

属性

RegisterAttribute

实现

IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

注解

对象 Locale 表示特定的地理、政治或文化区域。 需要执行 Locale 其任务的操作称为 <em>区域设置敏感</em> ，并使用 Locale 用户定制信息。 例如，显示数字是区域设置敏感操作—应根据用户的本机国家/地区或文化的习俗和约定设置数字的格式。

该 Locale 类实现 IETF BCP 47，它由 RFC 4647“语言标记匹配” 和 RFC 5646“标识语言的标记” 组成，支持 LDML（UTS#35、“Unicode 区域设置数据标记语言”）BCP 47 兼容的区域设置数据交换扩展。

从逻辑上讲，对象 Locale 由下面所述的字段组成。

<dl><dt>“def_language”><b>language</b></dt>

<dd>ISO 639 alpha-2 或 alpha-3 语言代码，或注册的语言子标记最多 8 个 alpha 字母（对于将来的增强）。 当语言同时具有 alpha-2 代码和 alpha-3 代码时，必须使用 alpha-2 代码。 可以在 IANA 语言子标记注册表中找到有效语言代码的完整列表（搜索“类型：语言”）。 语言字段不区分大小写，但 Locale 始终规范化为小写。</dd>

<dd>格式良好的语言值具有格式 [a-zA-Z]{2,8}。 请注意，这不是完整的 BCP47 语言生产，因为它不包括 extlang。 由于新式三字母语言代码替换了它们，因此不需要它们。</dd>

<dd>示例：“en”（英语）、“ja”（日语）、“kok”（Konkani）</dd>

<dt>“def_script”><b>script</b></dt>

<dd>ISO 15924 alpha-4 脚本代码。 可以在 IANA 语言子标记注册表中找到有效脚本代码的完整列表（搜索“类型：脚本”）。 脚本字段不区分大小写，但 Locale 始终规范为标题大小写（第一个字母为大写，其余字母为小写）。</dd>

<dd>格式正确的脚本值采用 /dd 格式[a-zA-Z]{4}<>

<dd>示例：“Latn”（拉丁语）、“Cyrl”（西里尔文）</dd>

<dt>“def_region”><b>country （region）</b></dt>

<dd>ISO 3166 alpha-2 国家/地区代码或 UN M.49 数字-3 区号。 可以在 IANA 语言子标记注册表中找到有效国家和地区代码的完整列表（搜索“类型：区域”）。 国家/地区字段不区分大小写，但 Locale 始终规范为大写。</dd>

<dd>格式良好的国家/地区值的格式为 [a-zA-Z]{2} | [0-9]{3}</dd>

<dd>示例：“US”（美国）、“FR”（法国）、“029”（加勒比）</dd>

<dt>“def_variant”><b>variant</b></dt>

<dd>用于指示变体的任何 Locale任意值。 如果每个变量值有两个或更多个指示其自己的语义，则这些值应按重要性排序，其中最重要的第一个值由下划线('_')分隔。 变体字段区分大小写。</dd>

<dd>注意：IETF BCP 47 将语法限制置于变体子标记上。 此外，BCP 47 子标记也严格用于指示定义语言或其方言的其他变体，这些变体不受语言、脚本和区域子标记的任何组合所涵盖。 可以在 IANA 语言子标记注册表中找到有效变体代码的完整列表（搜索“Type： variant”）。

但是，变量字段 Locale 以前用于任何类型的变体，而不仅仅是语言变体。 例如，Java SE 运行时环境中提供的一些受支持的变体表示其他区域性行为，例如日历类型或数字脚本。 在 BCP 47 中，此类信息不标识语言，受扩展子标记或专用使用子标记支持。</dd>

<dd>格式良好的变体值具有格式的窗体SUBTAG (('_'|'-') SUBTAG)*。SUBTAG = [0-9][0-9a-zA-Z]{3} | [0-9a-zA-Z]{5,8} （注意：BCP 47 仅使用连字符（'-'）作为分隔符，这更加宽大。</dd>

<dd>示例：“polyton”（Polytonic Greek）、“POSIX”</dd>

<dt>“def_extensions”><b>extensions</b></dt>

<dd>A 映射从单个字符键映射到字符串值，指示扩展与语言标识分开。 实现 BCP 47 扩展子标记和私有使用子标记的语义和语法中的扩展 Locale 。 扩展不区分大小写，但 Locale 规范化所有扩展键和值以小写形式。 请注意，扩展不能有空值。</dd>

<dd>格式良好的键是集中 [0-9a-zA-Z]的单个字符。 格式正确的值具有键“xSUBTAG = [0-9a-zA-Z]{1,8}”和其他键SUBTAG = [0-9a-zA-Z]{2,8}（即“x”允许单字符子标记）的窗体SUBTAG ('-' SUBTAG)*。</dd>

<dd>示例：key=“u”/value=“ca-japanese” （日语日历）， key=“x”/value=“java-1-7”</dd></dl>

<b>注意：</b> 尽管 BCP 47 要求在 IANA 语言子标记注册表中注册字段值，但 Locale 该类不提供任何验证功能。 Builder唯一检查单个字段是否满足语法要求（格式正确），但不验证值本身。 有关详细信息，请参阅Builder。

<h2>“def_locale_extension”>Unicode 区域设置/语言扩展</h2>

UTS#35，“Unicode 区域设置数据标记语言”定义可选属性和关键字，以替代或优化与区域设置关联的默认行为。 关键字由一对键和类型表示。 例如，“nu-thai”表示应将泰国本地数字（值：“thai”）用于设置数字格式（键：“nu”）。

关键字使用扩展键“u#UNICODE_LOCALE_EXTENSION”（）映射到 BCP 47 扩展值。 上面的示例“nu-thai”成为扩展“u-nu-thai”。

因此，当对象包含 Unicode 区域设置属性和关键字时 Locale ， getExtension(UNICODE_LOCALE_EXTENSION) 将返回表示此信息的字符串，例如“nu-thai”。 该 Locale 类还提供 #getUnicodeLocaleAttributes， #getUnicodeLocaleKeys并允许 #getUnicodeLocaleType 你直接访问 Unicode 区域设置属性和键/类型对。 当表示为字符串时，Unicode 区域设置扩展按字母顺序列出属性，后跟按字母顺序列出的键/类型序列（定义类型时，构成键类型的子标记的顺序是固定的）

格式正确的区域设置键具有格式 [0-9a-zA-Z]{2}。 格式正确的区域设置类型具有窗体 "" | [0-9a-zA-Z]{3,8} ('-' [0-9a-zA-Z]{3,8})* （可以是空的，也可以是长度为 3-8 个字母数字的一系列子标记）。 格式正确的区域设置属性具有窗体 [0-9a-zA-Z]{3,8} （它是与区域设置类型子标记具有相同形式的单个子标记）。

Unicode 区域设置扩展指定区域设置敏感服务中的可选行为。 尽管 LDML 规范定义了各种键和值，但Java运行时环境中的实际区域设置敏感服务实现可能不支持任何特定的 Unicode 区域设置属性或键/类型对。

<h3>“ObtainingLocale”>获取区域设置</h3>

可通过多种方式获取 Locale 对象。

<h4>Builder</h4>

使用 Builder 可以构造 Locale 符合 BCP 47 语法的对象。

<h4>工厂方法</h4>

该方法 #forLanguageTag 获取 Locale 格式正确的 BCP 47 语言标记的对象。 该方法#of(String, String, String)及其重载从上述给定language、country和/或variant定义对象中获取Locale对象。

<h4>区域设置常量</h4>

该 Locale 类提供了许多方便的常量，可用于获取 Locale 常用区域设置的对象。 例如，Locale.US是Locale美国的对象。

<h3>“LocaleMatching”>Locale Matching</h3>

如果应用程序或系统国际化并提供多个区域设置的本地化资源，则有时需要查找满足每个用户的特定首选项的一个或多个区域设置（或语言标记）。 请注意，此区域设置匹配文档中将术语“语言标记”与“区域设置”互换使用。

为了将用户的首选区域设置与一组语言标记匹配， RFC 4647 语言标记匹配 定义了两种机制：筛选和查找。 <em>筛选</em> 用于获取所有匹配的区域设置，而 <em>lookup</em> 用于选择最佳匹配区域设置。 匹配不区分大小写。 以下各节介绍了这些匹配机制。

用户的首选项称为 <em>Language Priority List</em> ，并表示为语言范围列表。 语法上有两种类型的语言范围：基本和扩展。 有关详细信息，请参阅Locale.LanguageRange Locale.LanguageRange。

<h4>筛选</h4>

筛选操作返回所有匹配的语言标记。 它在 RFC 4647 中定义，如下所示：“在筛选中，每个语言范围表示最不具体的语言标记（即具有最少子标记的语言标记）是可接受的匹配项。 匹配的标记集中的所有语言标记将具有与语言范围相等或更大的子标记数。 语言范围中的每个非通配符子标记都将出现在每个匹配的语言标记中。

有两种类型的筛选：基本语言范围的筛选（称为“基本筛选”）和扩展语言范围的筛选（称为“扩展筛选”）。 它们可能会根据给定语言优先级列表中包含的语言范围类型返回不同的结果。 Locale.FilteringMode 是一个参数，用于指定应如何完成筛选。

<h4>Lookup</h4>

查找操作返回最佳匹配的语言标记。 它按如下方式在 RFC 4647 中定义：“与筛选相比，每个语言范围表示可接受的匹配项最具体的标记。 根据用户的优先级找到的第一个匹配标记被视为最接近的匹配项，并且是返回的项。

例如，如果语言优先级列表由两种语言范围组成， "zh-Hant-TW" 并且 "en-US"按优先顺序，查找方法会逐渐搜索下面的语言标记，以便查找最佳匹配的语言标记。 <blockquote>

1. zh-Hant-TW
               2. zh-Hant
               3. zh
               4. en-US
               5. en

</blockquote> 如果语言标记与上面的语言范围完全匹配，则返回语言标记。

"*" 是特殊语言范围，在查找中将被忽略。

如果多种语言标记与语言范围中包含的子标记 '*' 匹配，则由 Iterator 语言标记返回的第一个 Collection 匹配语言标记被视为最佳匹配标记。

<h3>区域设置</h3 的使用>

获取后 Locale ，可以查询它以获取有关自身的信息。 用于 getCountry 获取国家/地区代码和 getLanguage 获取语言代码。 可用于 getDisplayCountry 获取适合向用户显示的国家/地区的名称。 同样，你可以使用 getDisplayLanguage 该语言获取适合向用户显示的语言的名称。 有趣的是，这些 getDisplayXXX 方法本身区分区域设置，并具有两个版本：一个使用默认 Locale.Category#DISPLAY DISPLAY 区域设置，一个使用指定为参数的区域设置。

Java平台提供了许多执行区域设置敏感操作的类。 例如，类 NumberFormat 以区分区域设置的方式设置数字、货币和百分比的格式。 类（例如 NumberFormat ，有多个方便的方法用于创建该类型的默认对象）。 例如，该 NumberFormat 类提供了以下三种用于创建默认 NumberFormat 对象的便利方法：{

在 1.1 中添加。

Java文档java.util.Locale。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。

        Language is always lower case, country is always upper case, script is always title
        case, and extensions are always lower case.