ZoneId Classe

Definição

[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

Herança

Object

JavaObject

Object

ZoneId

Derivado

Java.Time.ZoneOffset

Atributos

RegisterAttribute

Implementações

IJavaObject IJavaPeerable ISerializable IDisposable

Comentários

Uma ID de fuso horário, como Europe/Paris.

Um ZoneId é usado para identificar as regras usadas para converter entre um Instant e um LocalDateTime. Há dois tipos distintos de ID: <ul><li>Deslocamentos fixos - um deslocamento totalmente resolvido de UTC/Greenwich, que usa o mesmo deslocamento para todas as regiões geográficas de<data/hora >local - uma área em que um conjunto específico de regras para encontrar o deslocamento de UTC/Greenwich aplica </ul> A maioria dos deslocamentos fixos são representados por ZoneOffset. Chamar #normalized() qualquer ZoneId um garantirá que uma ID de deslocamento fixa será representada como um ZoneOffset.

As regras reais, descrevendo quando e como o deslocamento é alterado, são definidas por ZoneRules. Essa classe é simplesmente uma ID usada para obter as regras subjacentes. Essa abordagem é tomada porque as regras são definidas pelos governos e mudam com frequência, enquanto a ID é estável.

A distinção tem outros efeitos. Serializar o ZoneId somente enviará a ID, enquanto serializar as regras envia todo o conjunto de dados. Da mesma forma, uma comparação de duas IDs examina apenas a ID, enquanto uma comparação de duas regras examina todo o conjunto de dados.

<IDs> de fuso horário h2</h2> A ID é exclusiva dentro do sistema. Há três tipos de ID.

O tipo mais simples de ID é o de ZoneOffset. Isso consiste em 'Z' e IDs começando com '+' ou '-'.

O próximo tipo de ID são IDs de estilo de deslocamento com alguma forma de prefixo, como 'GMT+2' ou 'UTC+01:00'. Os prefixos reconhecidos são 'UTC', 'GMT' e 'UT'. O deslocamento é o sufixo e será normalizado durante a criação. Essas IDs podem ser normalizadas para um ZoneOffset uso normalized().

O terceiro tipo de ID são IDs baseadas em região. Uma ID baseada em região deve ter dois ou mais caracteres e não começar com 'UTC', 'GMT', 'UT' '+' ou '-'. As IDs baseadas em região são definidas pela configuração. A configuração se concentra em fornecer a pesquisa da ID para o subjacente ZoneRules.

As regras de fuso horário são definidas por governos e mudam com frequência. Há várias organizações, conhecidas aqui como grupos, que monitoram as alterações de fuso horário e as agrupam. O grupo padrão é o TZDB (Banco de Dados de Fuso Horário) IANA. Outras organizações incluem IATA (o órgão do setor aéreo) e Microsoft.

Cada grupo define seu próprio formato para a ID da região fornecida por ele. O grupo TZDB define IDs como "Europa/Londres" ou "América/New_York". As IDs do TZDB têm precedência sobre outros grupos.

É altamente recomendável que o nome do grupo seja incluído em todas as IDs fornecidas por grupos diferentes do TZDB para evitar conflitos. Por exemplo, as IDs de região de fuso horário da companhia aérea IATA normalmente são as mesmas que o código do aeroporto de três letras. No entanto, o aeroporto de Utrecht tem o código "UTC", que é obviamente um conflito. O formato recomendado para IDs de região de grupos diferentes do TZDB é "group~region". Portanto, se os dados IATA fossem definidos, o aeroporto de Utrecht seria 'IATA~UTC'.

<h2>Serialização</h2> Essa classe pode ser serializada e armazena a ID da zona de cadeia de caracteres no formulário externo. A ZoneOffset subclasse usa um formato dedicado que armazena apenas o deslocamento de UTC/Greenwich.

Um ZoneId pode ser desserializado em um runtime Java em que a ID é desconhecida. Por exemplo, se um Java Runtime do lado do servidor tiver sido atualizado com uma nova ID de zona, mas o Java Runtime do lado do cliente não tiver sido atualizado. Nesse caso, o ZoneId objeto existirá e poderá ser consultado usando getId, , equals, hashCodee toStringgetDisplayNamenormalized. No entanto, qualquer chamada para a getRules qual falhará.ZoneRulesException Essa abordagem foi projetada para permitir que um ZonedDateTime seja carregado e consultado, mas não modificado, em um runtime Java com informações incompletas de fuso horário.

Adicionado em 1.8.

Java documentação para java.time.ZoneId.

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.