Locale Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

Locale

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

Commenti

Un Locale oggetto rappresenta un'area geografica, politica o culturale specifica. Un'operazione che richiede un Locale per eseguire l'attività è denominata <em>locale-sensitive</em> e usa per Locale personalizzare le informazioni per l'utente. Ad esempio, la visualizzazione di un numero è un'operazione sensibile alle impostazioni locali— Il numero deve essere formattato in base alle convenzioni e alle convenzioni del paese, dell'area geografica o delle impostazioni cultura dell'utente.

La Locale classe implementa IETF BCP 47, costituita da RFC 4647 "Corrispondenza dei tag di linguaggio" e RFC 5646 "Tags for Identification Languages" con supporto per LDML (UTS#35, "Unicode Locale Data Markup Language") BCP 47-compatible extensions for locale data exchange.

Un Locale oggetto è costituito logicamente dai campi descritti di seguito.

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

<dd>ISO 639 alfa-2 o alfa-3 codice di lingua o sottotag di lingua registrata fino a 8 lettere alfa (per miglioramenti futuri). Quando un linguaggio ha sia un codice alfa-2 che un codice alfa-3, è necessario usare il codice alfa-2. È possibile trovare un elenco completo dei codici linguistici validi nel Registro dei sottotag lingua IANA (cercare "Tipo: lingua"). Il campo della lingua non fa distinzione tra maiuscole e minuscole, ma Locale sempre canonizza in lettere minuscole.</dd>

<I valori della lingua dd>Ben formato hanno il formato [a-zA-Z]{2,8}. Si noti che non è la produzione completa del linguaggio BCP47, poiché esclude extlang. Non sono necessari perché i codici linguistici moderni a tre lettere li sostituiscono.</dd>

<Esempio dd>: "en" (inglese), "ja" (giapponese), "kok" (Konkani)</dd>

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

<codice script dd>ISO 15924 alfa-4. È possibile trovare un elenco completo dei codici di script validi nel Registro dei sottotag del linguaggio IANA (cercare "Tipo: script"). Il campo script non fa distinzione tra maiuscole e minuscole, ma Locale sempre canonizza in maiuscolo (la prima lettera è maiuscola e il resto delle lettere è minuscolo).</dd>

<I valori di script dd>Ben formato hanno il formato [a-zA-Z]{4}</dd>

<Esempio dd>: "Latn" (latino), "Cyrl" (cirillico)</dd>

<dt>"def_region"><b>country (region)</b></dt>

<dd>ISO 3166 alfa-2 codice paese o codice di area UN M.49 numeric-3. È possibile trovare un elenco completo dei codici validi per paese e area geografica nel Registro sottotag lingua IANA (cercare "Tipo: area geografica"). Il campo paese (area geografica) non fa distinzione tra maiuscole e minuscole, ma Locale viene sempre canonizzato in maiuscolo.</dd>

<i valori di paese/area geografica in formato dd>hanno il formato [a-zA-Z]{2} | [0-9]{3}</dd>

<Esempio dd>: "US" (Stati Uniti), "FR" (Francia), "029" (Caraibi)</dd>

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

<dd>Qualsiasi valore arbitrario utilizzato per indicare una variante di un oggetto Locale. Dove sono presenti due o più valori varianti ognuno che indica la propria semantica, questi valori devono essere ordinati in base all'importanza, con il primo aspetto più importante, separato da carattere di sottolineatura('_'). Il campo variant fa distinzione tra maiuscole e minuscole.</dd>

<dd>Nota: IETF BCP 47 pone restrizioni sintattiche sui sottotag varianti. Inoltre, i sottotag BCP 47 vengono usati esclusivamente per indicare varianti aggiuntive che definiscono una lingua o i suoi dialetti che non sono coperti da alcuna combinazione di sottotag di lingua, script e area. È possibile trovare un elenco completo di codici varianti validi nel Registro di sistema dei sottotag lingua IANA (cercare "Tipo: variant").

Tuttavia, il campo variante in Locale è stato storicamente usato per qualsiasi tipo di variazione, non solo varianti del linguaggio. Ad esempio, alcune varianti supportate disponibili in Java ambienti di runtime SE indicano comportamenti culturali alternativi, ad esempio il tipo di calendario o lo script numerico. In BCP 47 questo tipo di informazioni, che non identifica il linguaggio, è supportato da sottotag di estensione o sottotag di uso privato.</dd>

<I valori varianti dd>Ben formati hanno il formato SUBTAG (('_'|'-') SUBTAG)* in cui SUBTAG = [0-9][0-9a-zA-Z]{3} | [0-9a-zA-Z]{5,8}. (Nota: BCP 47 usa solo il trattino ('-') come delimitatore, questo è più leniente.</dd>

<Esempio dd>: "polyton" (greco politonico), "POSIX"</dd>

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

<dd>Una mappa da chiavi a caratteri singoli a valori stringa, che indicano estensioni diverse dall'identificazione della lingua. Le estensioni in Locale implementano la semantica e la sintassi dei sottotag di estensione BCP 47 e i sottotag di uso privato. Le estensioni non fanno distinzione tra maiuscole e minuscole, ma Locale canonizza tutte le chiavi di estensione e i valori in lettere minuscole. Si noti che le estensioni non possono avere valori vuoti.</dd>

<dd>Le chiavi ben formate sono caratteri singoli del set [0-9a-zA-Z]. I valori ben formati hanno il formato SUBTAG ('-' SUBTAG)* in cui per la chiave 'x' SUBTAG = [0-9a-zA-Z]{1,8} e per altre chiavi SUBTAG = [0-9a-zA-Z]{2,8} (ovvero 'x' consente sottotag a carattere singolo).</dd>

<Esempio dd>: key="u"/value="ca-japanese" (Calendario giapponese), key="x"/value="java-1-7"</dd></dl>

<b Nota:>/b<> Sebbene BCP 47 richieda la registrazione dei valori di campo nel Registro sottotag lingua IANA, la Locale classe non fornisce alcuna funzionalità di convalida. Controlla Builder solo se un singolo campo soddisfa il requisito sintattico (è ben formato), ma non convalida il valore stesso. Per informazioni dettagliate, vedere Builder.

<h2>"def_locale_extension">Impostazioni locali Unicode/estensione< del linguaggio/h2>

UTS#35, "Unicode Locale Data Markup Language" definisce attributi e parole chiave facoltativi per eseguire l'override o perfezionare il comportamento predefinito associato a impostazioni locali. Una parola chiave è rappresentata da una coppia di chiavi e tipo. Ad esempio, "nu-thai" indica che le cifre locali thai (value:"thai") devono essere usate per la formattazione dei numeri (key:"nu").

Le parole chiave vengono mappate a un valore di estensione BCP 47 usando la chiave di estensione 'u' (#UNICODE_LOCALE_EXTENSION). L'esempio precedente, "nu-thai", diventa l'estensione "u-nu-thai".

Pertanto, quando un Locale oggetto contiene attributi e parole chiave delle impostazioni locali Unicode, getExtension(UNICODE_LOCALE_EXTENSION) restituirà un valore String che rappresenta queste informazioni, ad esempio "nu-thai". La Locale classe fornisce #getUnicodeLocaleAttributesanche , #getUnicodeLocaleKeyse #getUnicodeLocaleType che consentono di accedere direttamente agli attributi delle impostazioni locali Unicode e alle coppie chiave/tipo. Se rappresentato come stringa, l'estensione delle impostazioni locali Unicode elenca gli attributi in ordine alfabetico, seguito da sequenze chiave/tipo con chiavi elencate alfabeticamente (l'ordine dei sottotag che comprendono il tipo di una chiave è fisso quando viene definito il tipo)

Una chiave delle impostazioni locali ben formata ha il formato [0-9a-zA-Z]{2}. Un tipo di impostazioni locali ben formato ha il formato "" | [0-9a-zA-Z]{3,8} ('-' [0-9a-zA-Z]{3,8})* (può essere vuoto o una serie di sottotag di lunghezza pari a 3-8 alfanume). Un attributo delle impostazioni locali ben formato ha il formato [0-9a-zA-Z]{3,8} (è un singolo sottotag con la stessa forma di un sottotag di tipo impostazioni locali).

L'estensione delle impostazioni locali Unicode specifica il comportamento facoltativo nei servizi sensibili alle impostazioni locali. Anche se la specifica LDML definisce diverse chiavi e valori, le implementazioni effettive del servizio sensibile alle impostazioni locali in un ambiente runtime di Java potrebbero non supportare specifici attributi delle impostazioni locali Unicode o coppie chiave/tipo.

<h3>"ObtainingLocale">Recupero di un'impostazione locale</h3>

Esistono diversi modi per ottenere un Locale oggetto.

<h4>Builder</h4>

Usando Builder è possibile costruire un Locale oggetto conforme alla sintassi BCP 47.

<h4>Factory Methods</h4>

Il metodo #forLanguageTag ottiene un Locale oggetto per un tag di lingua BCP 47 ben formato. Il metodo #of(String, String, String) e i relativi overload ottengono un Locale oggetto da , languagecountrye/o variant definito in precedenza.

<Costanti> h4<impostazioni locali/h4>

La Locale classe fornisce una serie di costanti utili che è possibile usare per ottenere Locale oggetti per le impostazioni locali di uso comune. Ad esempio, Locale.US è l'oggetto Locale per il Stati Uniti.

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

Se un'applicazione o un sistema è internazionalizzato e fornisce risorse localizzate per più impostazioni locali, a volte deve trovare una o più impostazioni locali (o tag di lingua) che soddisfano le preferenze specifiche di ogni utente. Si noti che un termine "tag lingua" viene usato in modo intercambiabile con "impostazioni locali" in questa documentazione di corrispondenza delle impostazioni locali.

Per associare le impostazioni locali preferite di un utente a un set di tag di lingua, la corrispondenza dei tag di lingua RFC 4647 definisce due meccanismi: filtro e ricerca. <em>Filtering</em> viene usato per ottenere tutte le impostazioni locali corrispondenti, mentre <em>lookup</em> consiste nel scegliere le impostazioni locali corrispondenti migliori. La corrispondenza viene eseguita senza distinzione tra maiuscole e minuscole. Questi meccanismi di corrispondenza sono descritti nelle sezioni seguenti.

La preferenza di un utente è denominata <>em Language Priority List</em> ed è espressa come elenco di intervalli di lingue. Esistono due tipi di intervalli di linguaggio sintatticamente: di base e estesi. Per informazioni dettagliate, vedere Locale.LanguageRange Locale.LanguageRange.

<filtro> h4</h4>

L'operazione di filtro restituisce tutti i tag di lingua corrispondenti. È definito in RFC 4647 come indicato di seguito: "Nel filtro, ogni intervallo di lingue rappresenta il tag di lingua meno specifico (ovvero il tag di lingua con il minor numero di sottotag) che è una corrispondenza accettabile. Tutti i tag di lingua nel set di tag corrispondente avranno un numero di sottotag uguale o maggiore rispetto all'intervallo di lingue. Ogni sottotag non con caratteri jolly nell'intervallo di lingue verrà visualizzato in ogni tag di lingua corrispondente".

Esistono due tipi di filtro: il filtro per gli intervalli di linguaggio di base (denominato "filtro di base") e il filtro per gli intervalli di linguaggio estesi (denominati "filtro esteso"). Possono restituire risultati diversi in base al tipo di intervalli di lingue inclusi nell'elenco di priorità lingua specificato. Locale.FilteringMode è un parametro per specificare la modalità di applicazione del filtro.

<h4>Ricerca</h4>

L'operazione di ricerca restituisce i tag di lingua corrispondenti migliori. È definito in RFC 4647 come indicato di seguito: "A differenza del filtro, ogni intervallo di linguaggio rappresenta il tag più specifico che è una corrispondenza accettabile. Il primo tag corrispondente trovato, in base alla priorità dell'utente, viene considerato la corrispondenza più vicina ed è l'elemento restituito".

Ad esempio, se un elenco di priorità lingua è costituito da due intervalli "zh-Hant-TW" di lingue e "en-US", in ordine di priorità, il metodo di ricerca cerca progressivamente i tag di lingua seguenti per trovare il tag di lingua migliore corrispondente. <blockquote>

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

</blockquote> Se è presente un tag di lingua che corrisponde completamente a un intervallo di lingua precedente, viene restituito il tag di lingua.

"*" è l'intervallo di lingue speciali e viene ignorato nella ricerca.

Se più tag di lingua corrispondono come risultato del sottotag '*' incluso in un intervallo di lingue, il primo tag di lingua corrispondente restituito da un Iterator oggetto su un Collection di tag di lingua viene considerato come il migliore corrispondente.

<h3>Uso delle impostazioni locali</h3>

Dopo aver ottenuto un Locale oggetto , è possibile eseguirne una query per ottenere informazioni su se stesso. Usare getCountry per ottenere il codice del paese (o dell'area geografica) e getLanguage ottenere il codice della lingua. È possibile usare getDisplayCountry per ottenere il nome del paese adatto per la visualizzazione all'utente. Analogamente, è possibile usare getDisplayLanguage per ottenere il nome della lingua adatta per la visualizzazione all'utente. È interessante notare che i getDisplayXXX metodi sono sensibili alle impostazioni locali e hanno due versioni: una che usa le impostazioni locali predefinite Locale.Category#DISPLAY DISPLAY e una che usa le impostazioni locali specificate come argomento.

La piattaforma Java fornisce una serie di classi che eseguono operazioni sensibili alle impostazioni locali. Ad esempio, la NumberFormat classe formatta numeri, valuta e percentuali in modo sensibile alle impostazioni locali. Le classi, NumberFormat ad esempio, hanno diversi metodi pratici per la creazione di un oggetto predefinito di tale tipo. Ad esempio, la NumberFormat classe fornisce questi tre metodi pratici per la creazione di un oggetto predefinito NumberFormat : {

Aggiunta nella versione 1.1.

per java.util.Locale.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

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