Locale Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Объект Locale представляет определенный географический, политический или культурный регион.
[Android.Runtime.Register("java/util/Locale", DoNotGenerateAcw=true)]
public sealed class Locale : Java.Lang.Object, IDisposable, 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- Наследование
- Атрибуты
- Реализации
Комментарии
Объект Locale представляет определенный географический, политический или культурный регион. Операция, требующая Locale выполнения задачи, называется <em>locale-sensitive</em> и использует Locale для настройки сведений для пользователя. Например, отображение числа — это операция с учетом языкового стандарта— число должно быть отформатировано в соответствии с обычаями и соглашениями о стране пользователя, регионе или культуре.
Класс Locale реализует IETF BCP 47, состоящий из RFC 4647 "Сопоставление тегов языка" и RFC 5646 "Теги для идентификации языков" с поддержкой LDML (UTS#35, "Язык разметки данных Юникода") BCP 47-совместимых расширений для обмена данными языкового стандарта.
Locale Объект логически состоит из полей, описанных ниже.
<dl><dt>"def_language"><b language>/b<></dt>
<dd>ISO 639 альфа-2 или альфа-3 языковой код или зарегистрированные подтеги языка до 8 альфа-букв (для будущих улучшений). Если язык содержит как код альфа-2, так и альфа-3, необходимо использовать код альфа-2. Полный список допустимых кодов языка можно найти в реестре подтегов языка IANA (найдите "Тип: язык"). Поле языка не учитывает регистр, но Locale всегда канонизируется в нижнем регистре.</dd>
<У dd>хорошо сформированных языковых значений есть форма [a-zA-Z]{2,8}. Обратите внимание, что это не полная рабочая среда языка BCP47, так как она исключает extlang. Они не нужны, так как современные коды языка с тремя буквами заменяют их.</dd>
<dd>Example: "en" (английский), "ja" (японский), "кок" (Konkani)</dd>
<dt>"def_script"><b script>/b<></dt>
<dd>ISO 15924 alpha-4 script code. Полный список допустимых кодов скриптов можно найти в реестре подтегов языка IANA (найдите "Тип: скрипт"). Поле скрипта не учитывает регистр, но Locale всегда канонизирует заголовок (первая буква является верхним регистром, а остальные буквы — строчным регистром).</dd>
<Значения скрипта dd>well-form имеют форму [a-zA-Z]{4}</dd>
<dd>Example: "Latn" (латиница), "Cyrl" (кириллица)</dd>
<dt>"def_region"><b country (region)>/b<></dt>
<dd>ISO 3166 alpha-2 country code или UN M.49 numeric-3 area code. Полный список допустимых кодов стран и регионов можно найти в реестре подтегов языка IANA (найдите "Тип: регион"). Поле страны (региона) не учитывает регистр, но Locale всегда канонизируется в верхнем регистре.</dd>
<Значения страны или региона dd>имеют форму [a-zA-Z]{2} | [0-9]{3}</dd>
<dd>Example: "US" (США), "FR" (Франция), "029" (Карибское море)</dd>
<dt>"def_variant"><b variant>/b<></dt>
<dd>Любое произвольное значение, используемое для указания варианта Locale. При наличии двух или более вариантных значений, указывающих собственную семантику, эти значения должны быть упорядочены по важности, с наиболее важным первым, разделенным подчеркиванием('_'). Поле варианта учитывает регистр.</dd>
<dd>Примечание. IETF BCP 47 помещает синтаксические ограничения на вариантные подтеги. Кроме того, подтеги BCP 47 строго используются для указания дополнительных вариантов, определяющих язык или его диалекты, которые не охватываются никакими сочетаниями языковых, скриптов и подтегов региона. Полный список допустимых кодов вариантов можно найти в реестре подтегов языка IANA (поиск "Тип: вариант").
Однако поле варианта в Locale истории использовалось для любого типа вариантов, а не только для языковых вариантов. Например, некоторые поддерживаемые варианты, доступные в средах выполнения SE Java, указывают на альтернативное культурное поведение, например тип календаря или скрипт числа. В BCP 47 эта информация, которая не определяет язык, поддерживается вложенными тегами расширения или частными подтегами использования.</dd>
<Dd>Хорошо сформированные значения вариантов имеют форму SUBTAG (('_'|'-') SUBTAG)* , в которой SUBTAG = [0-9][0-9a-zA-Z]{3} | [0-9a-zA-Z]{5,8}. (Примечание. BCP 47 использует дефис ('-) в качестве разделителя, это более лениво.</dd>
<dd>Example: "polyton" (Polytonic греческий), "POSIX"</dd>
<dt>"def_extensions"><b extensions>/b<></dt>
<dd>A сопоставляется с одним символьным ключом и строковыми значениями, указывая расширения, помимо идентификации языка. Расширения в Locale реализации семантики и синтаксиса подтег расширений BCP 47 и частных подтег использования. Расширения не учитывает регистр, но Locale канонизирует все ключи расширений и значения в нижнем регистре. Обратите внимание, что расширения не могут иметь пустые значения.</dd>
<Ключи dd>Well-formed — это одиночные символы из набора [0-9a-zA-Z]. У хорошо сформированных значений есть формаSUBTAG ('-' SUBTAG)*, в которой ключ "x" и для других ключей SUBTAG = [0-9a-zA-Z]{1,8} (то есть x) SUBTAG = [0-9a-zA-Z]{2,8} допускает однозначные подтеги.</dd>
<dd>Example: 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">Юникод языкового стандарта/расширения< языка/h2>
UTS#35 ,Язык разметки данных Юникода определяет необязательные атрибуты и ключевые слова для переопределения или уточнения поведения по умолчанию, связанного с языковым стандартом. Ключевое слово представлено парой ключей и типа. Например, "nu-thai" указывает, что тайский локальные цифры (значение:"тайский") должны использоваться для форматирования чисел (ключ:"nu").
Ключевые слова сопоставляются со значением расширения BCP 47 с помощью ключа расширения U (#UNICODE_LOCALE_EXTENSION). Приведенный выше пример nu-thai становится расширением u-nu-thai.
Таким образом, если Locale объект содержит атрибуты и ключевые слова языкового стандарта Юникода, getExtension(UNICODE_LOCALE_EXTENSION) возвращает строку, представляющую эту информацию, например nu-thai. Класс Locale также предоставляет #getUnicodeLocaleAttributesи #getUnicodeLocaleKeys#getUnicodeLocaleType позволяет напрямую получать доступ к атрибутам языкового стандарта Юникода и парам "ключ-тип". При представлении в виде строки расширение Юникода языкового стандарта перечисляет атрибуты в алфавитном порядке, а затем последовательности ключей и типов с ключами, перечисленными в алфавитном порядке (порядок вложенных тегов, состоящих из типа ключа, фиксируется при определении типа).
Хорошо сформированный ключ языкового стандарта имеет форму [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} (это один подтег с той же формой, что и подтег типа языкового стандарта).
Расширение языкового стандарта Юникода указывает необязательное поведение в службах с учетом языкового стандарта. Хотя спецификация LDML определяет различные ключи и значения, фактические реализации службы с учетом языкового стандарта в среде выполнения Java могут не поддерживать какие-либо определенные атрибуты языкового стандарта Юникода или пары типов ключей и типов.
<h3>"GetingLocale">Получение языкового< стандарта/h3>
Существует несколько способов получения Locale объекта.
<h4>Builder</h4>
С помощью Builder можно создать объект, соответствующий синтаксису Locale BCP 47.
<Методы фабрики> h4</h4>
Метод #forLanguageTag получает Locale объект для хорошо сформированного тега языка BCP 47. Метод #of(String, String, String) и его перегрузки получают объект из заданного Localelanguage, countryи /или variant определенного выше.
<H4>Locale Constants</h4>
Класс Locale предоставляет ряд удобных констант, которые можно использовать для получения Locale объектов для часто используемых языковых стандартов. Например, Locale.US это Locale объект для США.
<h3>"LocaleMatching"LocaleMatching">Locale Matching</h3>
Если приложение или система интернационализированы и предоставляет локализованные ресурсы для нескольких языковых стандартов, иногда необходимо найти один или несколько языков (или языковых тегов), которые соответствуют определенным предпочтениям каждого пользователя. Обратите внимание, что термин "тег языка" используется взаимозаменяемо с "языковым стандартом" в этой документации по сопоставлению языков.
Чтобы выполнить сопоставление предпочитаемых языковых стандартов пользователя с набором языковых тегов, RFC 4647 Matching of Language Tags определяет два механизма: фильтрацию и поиск. <Em>Filtering</em> используется для получения всех соответствующих языковых стандартов, в то время как<> em lookup</em> — выбрать наиболее подходящий языковой стандарт. Сопоставление выполняется без учета регистра. Эти механизмы сопоставления описаны в следующих разделах.
Предпочтения пользователя называются списком <>приоритетов< языка em или em> и выражаются как список диапазонов языков. Существует синтаксически два типа диапазонов языков: базовый и расширенный. Подробные сведения см. в разделе Locale.LanguageRange Locale.LanguageRange.
<h4>Filtering</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> , если есть тег языка, который полностью соответствует диапазону языка выше, возвращается тег языка.
"*" — это специальный диапазон языков, и он игнорируется при поиске.
Если несколько тегов языка совпадают в результате подтега '*' , включенного в диапазон языков, первый соответствующий тег языка, возвращаемый IteratorCollection поверх тегов языка, рассматривается как наиболее подходящий.
<H3>Использование языкового стандарта</h3>
Locale Получив запрос к нему, вы можете запросить сведения о себе. Используется getCountry для получения кода страны (или региона) и getLanguage получения языкового кода. Вы можете использовать getDisplayCountry для получения имени страны, подходящей для отображения пользователю. Аналогичным образом можно использовать getDisplayLanguage для получения имени языка, подходящего для отображения пользователю. Интересно, что методы getDisplayXXX сами являются языковыми стандартами и имеют две версии: одна, которая использует языковой стандарт по умолчанию Locale.Category#DISPLAY DISPLAY и тот, который использует языковой стандарт, указанный в качестве аргумента.
Платформа Java предоставляет ряд классов, выполняющих операции с учетом языкового стандарта. Например, NumberFormat класс форматирует числа, валюту и проценты в соответствии с языковым стандартом. Классы, такие как NumberFormat несколько удобных методов для создания объекта по умолчанию этого типа. Например, NumberFormat класс предоставляет три удобных метода для создания объекта по умолчанию NumberFormat : {
Добавлено в версии 1.1.
Java документации по java.util.Locale.
Части этой страницы — это изменения на основе работы, созданной и общей Project и используемых в соответствии с условиями, описанными в разделе "".
Конструкторы
| Имя. | Описание |
|---|---|
| Locale(String, String, String) |
Создайте языковой стандарт из языка, страны и варианта. |
| Locale(String, String) |
Создайте языковой стандарт из языка и страны. |
| Locale(String) |
Создайте языковой стандарт из языкового кода. |
Поля
| Имя. | Описание |
|---|---|
| PrivateUseExtension |
Ключ для расширения закрытого использования ('x'). |
| UnicodeLocaleExtension |
Ключ расширения языкового стандарта Юникода ('u'). |
Свойства
| Имя. | Описание |
|---|---|
| Canada |
Полезная константа для страны. |
| CanadaFrench |
Полезная константа для страны. |
| China |
Полезная константа для страны. |
| Chinese |
Полезная константа для языка. |
| Class |
Возвращает класс среды выполнения этого |
| Country |
Возвращает код страны или региона для этого языкового стандарта, который должен быть пустой строкой, верхним регистром ISO 3166 2-буквенный код или UN M. |
| Default |
Возвращает текущее значение языкового стандарта по умолчанию для этого экземпляра виртуальной машины Java. —или— задает языковой стандарт по умолчанию для этого экземпляра виртуальной машины Java. |
| DisplayCountry |
Возвращает имя страны языкового стандарта, подходящей для отображения пользователю. |
| DisplayLanguage |
Возвращает имя языка языкового стандарта, подходящего для отображения пользователю. |
| DisplayName |
Возвращает имя языкового стандарта, подходящего для отображения пользователю. |
| DisplayScript |
Возвращает имя скрипта языкового стандарта, подходящего для отображения пользователю. |
| DisplayVariant |
Возвращает имя для кода варианта языкового стандарта, подходящего для отображения пользователю. |
| English |
Полезная константа для языка. |
| ExtensionKeys |
Возвращает набор ключей расширений, связанных с этим языковым стандартом, или пустой набор, если он не имеет расширений. |
| France |
Полезная константа для страны. |
| French |
Полезная константа для языка. |
| German |
Полезная константа для языка. |
| Germany |
Полезная константа для страны. |
| Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
| HasExtensions |
Возвращает, |
| ISO3Country |
Возвращает трехбуквенное сокращение для страны языкового стандарта. |
| ISO3Language |
Возвращает трехбуквенное сокращение языка языкового стандарта. |
| Italian |
Полезная константа для языка. |
| Italy |
Полезная константа для страны. |
| Japan |
Полезная константа для страны. |
| Japanese |
Полезная константа для языка. |
| JniIdentityHashCode |
Возвращает хэш-код удостоверения, назначенный этому Java одноранговой среде выполнения взаимодействия. (Унаследовано от Object) |
| JniManagedPeerState |
Объект |
| JniPeerMembers |
Объект |
| Korea |
Полезная константа для страны. |
| Korean |
Полезная константа для языка. |
| Language |
Возвращает языковой код этого языкового стандарта. |
| PeerReference |
Возвращает ссылку на объект JNI для этого Java однорангового узла. (Унаследовано от Object) |
| Prc |
Полезная константа для страны. |
| Root |
Полезная константа для корневого языкового стандарта. |
| Script |
Возвращает скрипт для этого языкового стандарта, который должен быть пустой строкой или кодом скрипта ISO 15924 4-буквы. |
| SimplifiedChinese |
Полезная константа для языка. |
| Taiwan |
Полезная константа для страны. |
| ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
| ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
| TraditionalChinese |
Полезная константа для языка. |
| Uk |
Полезная константа для страны. |
| UnicodeLocaleAttributes |
Возвращает набор атрибутов языкового стандарта юникода, связанных с этим языковым стандартом, или пустой набор, если он не имеет атрибутов. |
| UnicodeLocaleKeys |
Возвращает набор ключей языковОго стандарта Юникода, определенных этим языковым стандартом, или пустой набор, если этот языковой стандарт отсутствует. |
| Us |
Полезная константа для страны. |
| Variant |
Возвращает код варианта для этого языкового стандарта. |
Методы
| Имя. | Описание |
|---|---|
| Clone() |
Переопределяет клонирование. |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Объект |
| Dispose() |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| Dispose(Boolean) |
Освобождает ресурсы, удерживаемые этим Java одноранговым узлом. (Унаследовано от Object) |
| DisposeUnlessReferenced() |
Объект |
| Equals(Object) |
Объект |
| Equals(Object) |
Указывает, равен ли другой объект этому объекту. (Унаследовано от Object) |
| Filter(IList<Locale.LanguageRange>, ICollection<Locale>, Locale+FilteringMode) |
Возвращает список соответствующих |
| Filter(IList<Locale.LanguageRange>, ICollection<Locale>) |
Возвращает список соответствующих |
| FilterTags(IList<Locale.LanguageRange>, ICollection<String>, Locale+FilteringMode) |
Возвращает список совпадающих тегов языков с помощью базового механизма фильтрации, определенного в RFC 4647. |
| FilterTags(IList<Locale.LanguageRange>, ICollection<String>) |
Возвращает список совпадающих тегов языков с помощью базового механизма фильтрации, определенного в RFC 4647. |
| ForLanguageTag(String) |
Возвращает языковой стандарт для указанной строки тега языка IETF BCP 47. |
| GetAvailableLocales() |
Возвращает массив всех установленных языковых стандартов. |
| GetDefault(Locale+Category) |
Возвращает текущее значение языкового стандарта по умолчанию для этого экземпляра виртуальной машины Java. |
| GetDisplayCountry(Locale) |
Возвращает имя страны этого языкового стандарта, локализованной |
| GetDisplayLanguage(Locale) |
Возвращает имя языка этого языкового стандарта, локализованного в |
| GetDisplayName(Locale) |
Возвращает имя языка, имя страны и вариант языкового стандарта, локализованное в |
| GetDisplayScript(Locale) |
Возвращает имя скрипта языкового стандарта, подходящего для отображения пользователю. |
| GetDisplayVariant(Locale) |
Возвращает имя для кода варианта языкового стандарта, подходящего для отображения пользователю. |
| GetExtension(Char) |
Возвращает значение расширения (или частного использования), связанное с указанным ключом, или значение NULL, если с ключом нет расширения. |
| GetHashCode() |
Возвращает значение хэш-кода для объекта. (Унаследовано от Object) |
| GetISOCountries() |
Возвращает список всех 2-буквных кодов стран, определенных в ISO 3166. |
| GetISOCountries(Locale+IsoCountryCode) |
Объект |
| GetISOLanguages() |
Возвращает список всех 2-буквовых кодов языка и некоторые из 3 букв, определенных в ISO 639. |
| GetUnicodeLocaleType(String) |
Возвращает тип языкового стандарта Юникода, связанный с указанным ключом языкового стандарта Юникода для этого языкового стандарта. |
| JavaFinalize() |
Устаревшие.
Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object) |
| Lookup(IList<Locale.LanguageRange>, ICollection<Locale>) |
|
| LookupTag(IList<Locale.LanguageRange>, ICollection<String>) |
Возвращает наиболее подходящий тег языка с помощью механизма подстановки, определенного в RFC 4647. |
| Notify() |
Пробуждение одного потока, ожидающего монитора этого объекта. (Унаследовано от Object) |
| NotifyAll() |
Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object) |
| Of(String, String, String) |
Объект |
| Of(String, String) |
Объект |
| Of(String) |
Объект |
| SetDefault(Locale+Category, Locale) |
Задает языковой стандарт по умолчанию для указанной категории для этого экземпляра виртуальной машины Java. |
| SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Объект |
| StripExtensions() |
Возвращает копию этого |
| ToArray<T>() |
Создает управляемый массив из этого Java оболочки массива. (Унаследовано от Object) |
| ToLanguageTag() |
Возвращает хорошо сформированный тег языка IETF BCP 47, представляющий этот языковой стандарт. |
| ToString() |
Возвращает строковое представление этого |
| UnregisterFromRuntime() |
Отменяет регистрацию этого Java однорангового узла из среды выполнения взаимодействия. (Унаследовано от Object) |
| Wait() |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>помощи уведомления</em> или <эм>прерванного</em>. (Унаследовано от Object) |
| Wait(Int64, Int32) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
| Wait(Int64) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
Явные реализации интерфейса
| Имя. | Описание |
|---|---|
| IJavaPeerable.Disposed() |
Объект |
| IJavaPeerable.Finalized() |
Объект |
| IJavaPeerable.JniObjectReferenceControlBlock |
Объект |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Объект |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Объект |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Объект |
| IJavaPeerable.UnregisterFromRuntime() |
Объект |
Методы расширения
| Имя. | Описание |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Возвращает имя JNI типа экземпляра |
| JavaAs<TResult>(IJavaPeerable) |
Попробуйте принуждать к типу |
| JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверяемого средой выполнения Android. |
| JavaCast<TResult>(IJavaObject) |
Объект |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Попробуйте принуждать к типу |