ZoneId Classe

Definizione

[Android.Runtime.Register("java/time/ZoneId", ApiSince=26, DoNotGenerateAcw=true)]
public abstract class ZoneId : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("java/time/ZoneId", ApiSince=26, DoNotGenerateAcw=true)>]
type ZoneId = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Ereditarietà

Object

JavaObject

Object

ZoneId

Derivato

Java.Time.ZoneOffset

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable ISerializable IDisposable

Commenti

ID fuso orario, ad esempio Europe/Paris.

Un ZoneId oggetto viene utilizzato per identificare le regole utilizzate per la conversione tra un oggetto Instant e un oggetto LocalDateTime. Esistono due tipi distinti di ID: ul<li Fixed offsets- >un offset completamente risolto da UTC/Greenwich, che usa lo stesso offset per tutte le aree geografiche di data e ora<> locali- un'area in cui un set specifico di regole per trovare l'offset dall'ora UTC/Greenwich applicano <gli offset fissi /ul> Most sono rappresentati da <.>ZoneOffset La chiamata #normalized() a qualsiasi ZoneId garantisce che un ID offset fisso venga rappresentato come .ZoneOffset

Le regole effettive, che descrivono quando e come cambiano l'offset, sono definite da ZoneRules. Questa classe è semplicemente un ID usato per ottenere le regole sottostanti. Questo approccio viene adottato perché le regole sono definite dai governi e cambiano frequentemente, mentre l'ID è stabile.

La distinzione ha altri effetti. La serializzazione ZoneId di invierà solo l'ID, mentre la serializzazione delle regole invia l'intero set di dati. Analogamente, un confronto di due ID esamina solo l'ID, mentre un confronto di due regole esamina l'intero set di dati.

<h2>ID< fuso orario/h2> L'ID è univoco all'interno del sistema. Esistono tre tipi di ID.

Il tipo più semplice di ID è che da ZoneOffset. Si tratta di ID e 'Z' che iniziano con '+' o '-'.

Il tipo di ID successivo è costituito da ID di tipo offset con una forma di prefisso, ad esempio 'GMT+2' o 'UTC+01:00'. I prefissi riconosciuti sono 'UTC', 'GMT' e 'UT'. L'offset è il suffisso e verrà normalizzato durante la creazione. Questi ID possono essere normalizzati in un ZoneOffset oggetto usando normalized().

Il terzo tipo di ID è costituito da ID basati sull'area. Un ID basato sull'area deve avere due o più caratteri e non iniziare con 'UTC', 'GMT', 'UT' '+' o '-'. Gli ID basati sull'area sono definiti dalla configurazione. La configurazione è incentrata sulla fornitura della ricerca dall'ID all'oggetto sottostante ZoneRules.

Le regole del fuso orario sono definite dai governi e cambiano frequentemente. Esistono diverse organizzazioni, note qui come gruppi, che monitorano le modifiche del fuso orario e le comprimono. Il gruppo predefinito è IANA Time Zone Database (TZDB). Altre organizzazioni includono IATA (l'ente del settore aereo) e Microsoft.

Ogni gruppo definisce il proprio formato per l'ID area specificato. Il gruppo TZDB definisce ID come "Europa/Londra" o "America/New_York". Gli ID TZDB hanno la precedenza su altri gruppi.

È consigliabile includere il nome del gruppo in tutti gli ID forniti da gruppi diversi da TZDB per evitare conflitti. Ad esempio, gli ID dell'area del fuso orario della compagnia aerea IATA sono in genere gli stessi del codice aeroporto di tre lettere. Tuttavia, l'aeroporto di Ciononostante ha il codice "UTC", che ovviamente è un conflitto. Il formato consigliato per gli ID di area da gruppi diversi da TZDB è "group~region". Pertanto, se i dati IATA fossero definiti, l'aeroporto di Praga sarebbe 'IATA~UTC'.

<h2>Serialization</h2> Questa classe può essere serializzata e archivia l'ID della zona stringa nel formato esterno. La ZoneOffset sottoclasse usa un formato dedicato che archivia solo l'offset dall'ora UTC/Greenwich.

Un ZoneId oggetto può essere deserializzato in un runtime di Java in cui l'ID è sconosciuto. Ad esempio, se un runtime di Java lato server è stato aggiornato con un nuovo ID zona, ma il Java runtime sul lato client non è stato aggiornato. In questo caso, l'oggetto ZoneId esiste e può essere sottoposto a query usando getId, equalshashCode, toString, getDisplayName e normalized. Tuttavia, qualsiasi chiamata a getRules avrà esito negativo con ZoneRulesException. Questo approccio è progettato per consentire ZonedDateTime il caricamento e l'esecuzione di query su un runtime di Java con informazioni incomplete sul fuso orario.

Aggiunta nella versione 1.8.

per java.time.ZoneId.

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.