Locale Classe

Definição

[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

Herança

Object

JavaObject

Object

Locale

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

Comentários

Um Locale objeto representa uma região geográfica, política ou cultural específica. Uma operação que exige Locale a execução de sua tarefa é chamada <em>localidade sensível</em> e usa as Locale informações para personalizar as informações para o usuário. Por exemplo, exibir um número é uma operação sensível à localidade— o número deve ser formatado de acordo com os costumes e convenções do país nativo, da região ou da cultura do usuário.

A Locale classe implementa o IETF BCP 47, que é composto por RFC 4647 "Correspondência de Marcas de Idioma" e RFC 5646 "Marcas para Identificar Idiomas" com suporte para o LDML (UTS#35, "Unicode Locale Data Markup Language") extensões compatíveis com BCP 47 para troca de dados de localidade.

Um Locale objeto consiste logicamente nos campos descritos abaixo.

<dl><dt>"def_language"><b>language</b></dt>

<dd>ISO 639 alfa-2 ou alfa-3 código de idioma ou subtags de idioma registrado até 8 letras alfa (para aprimoramentos futuros). Quando uma linguagem tem um código alfa-2 e um código alfa-3, o código alfa-2 deve ser usado. Você pode encontrar uma lista completa de códigos de idioma válidos no Registro de Subtag de Idioma IANA (pesquise por "Tipo: idioma"). O campo de linguagem não diferencia maiúsculas de minúsculas, mas Locale sempre canoniza para letras minúsculas.</dd>

<os valores de linguagem bem formados dd>têm o formulário [a-zA-Z]{2,8}. Observe que essa não é a produção completa da linguagem BCP47, pois exclui a extlang. Eles não são necessários, pois os códigos de idioma modernos de três letras os substituem.</dd>

<exemplo de dd>: "en" (inglês), "ja" (japonês), "kok" (Konkani)</dd>

<dt>"def_script"><b>script</b></dt>

<código de script iso 15924 alfa-4 dd>. Você pode encontrar uma lista completa de códigos de script válidos no Registro de Subtag de Idioma IANA (pesquise por "Tipo: script"). O campo de script não diferencia maiúsculas de minúsculas, mas Locale sempre canoniza para maiúsculas e minúsculas (a primeira letra é maiúscula e minúsculas).</dd>

<DD>Valores de script bem formados têm o formulário [a-zA-Z]{4}</dd>

<dd>Exemplo: "Latn" (latino), "Cyrl" (cirílico)</dd>

<dt>"def_region"><b>país (região)</b></dt>

< >código de país iso 3166 alfa-2 ou código de área M.49 numeric-3 da ONU. Você pode encontrar uma lista completa de códigos de país e região válidos no Registro de Subtag de Idioma IANA (pesquise por "Tipo: região"). O campo país (região) não diferencia maiúsculas de minúsculas, mas Locale sempre canoniza para maiúsculas e minúsculas.</dd>

<dd>Valores de país/região bem formados têm o formulário [a-zA-Z]{2} | [0-9]{3}</dd>

<exemplo de dd>: "US" (Estados Unidos), "FR" (França), "029" (Caribe)</dd>

<dt>"def_variant"><b>variant</b></dt>

<dd>Qualquer valor arbitrário usado para indicar uma variação de um Locale. Onde há dois ou mais valores variantes cada um indicando sua própria semântica, esses valores devem ser ordenados por importância, com o mais importante primeiro, separados por sublinhado('_'). O campo variant diferencia maiúsculas de minúsculas.</dd>

<Observação dd>: O IETF BCP 47 coloca restrições sintacticas em subtags variantes. Além disso, as subtags BCP 47 são estritamente usadas para indicar variações adicionais que definem uma linguagem ou seus dialetos que não são cobertos por nenhuma combinação de linguagem, script e subtags de região. Você pode encontrar uma lista completa de códigos variantes válidos no Registro de Subtag de Idioma IANA (pesquise por "Tipo: variante").

No entanto, o campo variante em Locale tem sido historicamente usado para qualquer tipo de variação, não apenas variações de idioma. Por exemplo, algumas variantes com suporte disponíveis em ambientes de runtime se Java indicam comportamentos culturais alternativos, como tipo de calendário ou script numérico. No BCP 47, esse tipo de informação, que não identifica o idioma, tem suporte por subtags de extensão ou subtags de uso privado.</dd>

< >os valores de variante bem formados têm o formulário SUBTAG (('_'|'-') SUBTAG)* em SUBTAG = [0-9][0-9a-zA-Z]{3} | [0-9a-zA-Z]{5,8}que . (Observação: BCP 47 usa apenas hífen ('-') como delimitador, isso é mais brando).</dd>

<dd>Exemplo: "polyton" (grego politônico), "POSIX"</dd>

<dt>"def_extensions"><b>extensions</b></dt>

<dd>Um mapa de chaves de caractere único para valores de cadeia de caracteres, indicando extensões além da identificação do idioma. As extensões na Locale implementação da semântica e sintaxe de subtags de extensão BCP 47 e subtags de uso privado. As extensões não diferenciam maiúsculas de minúsculas, mas Locale canonizam todas as chaves de extensão e valores para minúsculas. Observe que as extensões não podem ter valores vazios.</dd>

<as chaves bem formadas dd>são caracteres únicos do conjunto [0-9a-zA-Z]. Valores bem formados têm o formulário SUBTAG ('-' SUBTAG)* em que para a chave 'x' SUBTAG = [0-9a-zA-Z]{1,8} e para outras chaves SUBTAG = [0-9a-zA-Z]{2,8} (ou seja, 'x' permite subtags de caractere único).</dd>

<exemplo de dd>: key="u"/value="ca-japanese" (Calendário japonês), key="x"/value="java-1-7"</dd></dl>

<b>Observação:</b> Embora o BCP 47 exija que os valores de campo sejam registrados no Registro de Subtag de Idioma IANA, a Locale classe não fornece nenhum recurso de validação. A Builder única verifica se um campo individual atende ao requisito sintactico (está bem formado), mas não valida o valor em si. Consulte Builder para obter detalhes.

<h2>"def_locale_extension">Unicode locale/language extension</h2>

UTS#35, "Unicode Locale Data Markup Language" define atributos opcionais e palavras-chave para substituir ou refinar o comportamento padrão associado a uma localidade. Uma palavra-chave é representada por um par de chave e tipo. Por exemplo, "nu-thai" indica que dígitos locais tailandeses (valor:"thai") devem ser usados para formatação de números (chave:"nu").

As palavras-chave são mapeadas para um valor de extensão BCP 47 usando a chave de extensão 'u' (#UNICODE_LOCALE_EXTENSION). O exemplo acima, "nu-thai", torna-se a extensão "u-nu-thai".

Assim, quando um Locale objeto contiver atributos de localidade Unicode e palavras-chave, getExtension(UNICODE_LOCALE_EXTENSION) retornará uma cadeia de caracteres que representa essas informações, por exemplo, "nu-thai". A Locale classe também fornece #getUnicodeLocaleAttributes, #getUnicodeLocaleKeyse #getUnicodeLocaleType que permitem acessar diretamente atributos de localidade Unicode e pares chave/tipo. Quando representada como uma cadeia de caracteres, a Extensão de Localidade Unicode lista atributos em ordem alfabética, seguida por sequências de chave/tipo com chaves listadas em ordem alfabética (a ordem das subtags que compõem o tipo de chave é corrigida quando o tipo é definido)

Uma chave de localidade bem formada tem o formulário [0-9a-zA-Z]{2}. Um tipo de localidade bem formado tem o formulário "" | [0-9a-zA-Z]{3,8} ('-' [0-9a-zA-Z]{3,8})* (pode estar vazio ou uma série de subtags de 3 a 8 alfanumes de comprimento). Um atributo de localidade bem formado tem o formulário [0-9a-zA-Z]{3,8} (é uma única subtag com o mesmo formulário de uma subtag de tipo de localidade).

A extensão de localidade Unicode especifica o comportamento opcional em serviços sensíveis à localidade. Embora a especificação LDML defina várias chaves e valores, as implementações reais do serviço que diferenciam a localidade em um ambiente de runtime Java podem não dar suporte a nenhum atributo de localidade Unicode específico ou pares chave/tipo.

<h3>"ObtainingLocale">Obtendo uma localidade</h3>

Há várias maneiras de obter um Locale objeto.

<h4>Builder</h4>

Usando Builder você pode construir um Locale objeto que esteja em conformidade com a sintaxe BCP 47.

<Métodos> de fábrica h4</h4>

O método #forLanguageTag obtém um Locale objeto para uma marca de idioma BCP 47 bem formada. O método #of(String, String, String) e suas sobrecargas obtêm um Locale objeto de determinado language, countrye/ou variant definido acima.

<Constantes> de localidade h4</h4>

A Locale classe fornece uma série de constantes convenientes que você pode usar para obter Locale objetos para localidades comumente usadas. Por exemplo, Locale.US é o Locale objeto do Estados Unidos.

<h3>"LocaleMatching">Locale Matching</h3>

Se um aplicativo ou um sistema for internacionalizado e fornecer recursos localizados para várias localidades, ele às vezes precisará encontrar uma ou mais localidades (ou marcas de idioma) que atendam às preferências específicas de cada usuário. Observe que um termo "marca de idioma" é usado de forma intercambiável com "localidade" nesta documentação de correspondência de localidade.

Para fazer a correspondência das localidades preferidas de um usuário a um conjunto de marcas de idioma, a Correspondência de Marcas de Idioma rfc 4647 define dois mecanismos: filtragem e pesquisa. <em>Filtragem</em> é usado para obter todas as localidades correspondentes, enquanto <em>pesquisa</em> é escolher a melhor localidade correspondente. A correspondência não diferencia maiúsculas de minúsculas. Esses mecanismos de correspondência são descritos nas seções a seguir.

A preferência de um usuário é chamada em <>Lista< de Prioridade de Idioma/em> e é expressa como uma lista de intervalos de idiomas. Há sintaticamente dois tipos de intervalos de idiomas: básico e estendido. Consulte Locale.LanguageRange Locale.LanguageRange para obter detalhes.

<Filtragem> h4</h4>

A operação de filtragem retorna todas as marcas de idioma correspondentes. Ele é definido no RFC 4647 da seguinte maneira: "Na filtragem, cada intervalo de idiomas representa a marca de idioma menos específica (ou seja, a marca de idioma com menos número de subtags) que é uma correspondência aceitável. Todas as marcas de idioma no conjunto de marcas correspondentes terão um número igual ou maior de subtags do que o intervalo de idiomas. Cada subtag não curinga no intervalo de idiomas aparecerá em cada uma das marcas de idioma correspondentes."

Há dois tipos de filtragem: filtragem para intervalos de idiomas básicos (chamados de "filtragem básica") e filtragem para intervalos de idioma estendidos (chamados de "filtragem estendida"). Eles podem retornar resultados diferentes por que tipo de intervalos de idiomas estão incluídos na lista de prioridade de idioma fornecida. Locale.FilteringMode é um parâmetro para especificar como a filtragem deve ser feita.

<Pesquisa> h4</h4>

A operação de pesquisa retorna as melhores marcas de idioma correspondentes. Ele é definido no RFC 4647 da seguinte maneira: "Em contraste com a filtragem, cada intervalo de idiomas representa a marca mais específica que é uma correspondência aceitável. A primeira marca correspondente encontrada, de acordo com a prioridade do usuário, é considerada a correspondência mais próxima e é o item retornado."

Por exemplo, se uma Lista de Prioridade de Idioma consiste em dois intervalos de idiomas e"zh-Hant-TW", "en-US" em ordem priorizada, o método de pesquisa pesquisa pesquisa progressivamente as marcas de idioma abaixo para encontrar a melhor marca de idioma correspondente. <blockquote>

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

</blockquote> Se houver uma marca de idioma que corresponda completamente a um intervalo de idiomas acima, a marca de idioma será retornada.

"*" é o intervalo de idiomas especial e é ignorado na pesquisa.

Se várias marcas de idioma corresponderem como resultado da subtag '*' incluída em um intervalo de idiomas, a primeira marca de idioma correspondente retornada por uma IteratorCollection das marcas de idioma será tratada como a melhor correspondente.

<h3>Uso de Localidade</h3>

Depois de obter um, Locale você pode consultá-lo para obter informações sobre si mesmo. Use getCountry para obter o código do país (ou região) e getLanguage para obter o código de idioma. Você pode usar getDisplayCountry para obter o nome do país adequado para exibição ao usuário. Da mesma forma, você pode usar getDisplayLanguage para obter o nome do idioma adequado para exibição ao usuário. Curiosamente, os getDisplayXXX métodos diferenciam a localidade e têm duas versões: uma que usa a localidade padrão Locale.Category#DISPLAY DISPLAY e outra que usa a localidade especificada como argumento.

A Plataforma Java fornece várias classes que executam operações sensíveis à localidade. Por exemplo, a NumberFormat classe formata números, moeda e porcentagens de maneira sensível à localidade. Classes como NumberFormat têm vários métodos de conveniência para criar um objeto padrão desse tipo. Por exemplo, a NumberFormat classe fornece estes três métodos de conveniência para criar um objeto padrão NumberFormat : {

Adicionado em 1.1.

Documentação Java para java.util.Locale.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

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