Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

ZoneId — um identificador de fuso horário

ZoneId identifica um fuso horário, enquanto ZoneRules descreve as respetivas regras de desvio em relação a UTC. Aprende ZoneId.of, ZoneId.getRules e a diferença entre uma região e um desvio fixo.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();

java.time.ZoneId identifica um fuso horário; não armazena uma data nem uma hora. ZoneId.of(String) cria um identificador de região, como Europe/Paris, ou de desvio fixo, como +02:00. Uma região não é o mesmo que um desvio fixo.

ZoneId.getRules() devolve ZoneRules. O método getOffset(Instant) fornece o desvio aplicável a um instante específico, enquanto isFixedOffset() verifica se esse desvio nunca muda. As regras regionais podem incluir mudanças da hora e dependem dos dados disponíveis no ambiente de execução.

A um Instant corresponde um único desvio aplicável. No entanto, ao converter um LocalDateTime, uma transição de desvio pode criar uma lacuna ou uma sobreposição nas horas locais. getValidOffsets(LocalDateTime) ajuda a identificar estes casos; não partas do princípio de que uma hora local identifica sempre um único instante.

Um formato inválido passado a ZoneId.of provoca DateTimeException, enquanto uma região desconhecida provoca ZoneRulesException. ZoneId.getRules também pode lançar ZoneRulesException se as regras não estiverem disponíveis. O exemplo utiliza um desvio fixo e um instante definido, para que o resultado não dependa do relógio nem de atualizações dos dados regionais.

Exemplos

import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;

public class Main {
    public static void main(String[] args) {
        ZoneId zone = ZoneId.of("+02:00");
        ZoneRules rules = zone.getRules();
        Instant instant = Instant.parse("2024-01-15T12:00:00Z");

        System.out.println(zone.getId());
        System.out.println(rules.isFixedOffset());
        System.out.println(rules.getOffset(instant));
    }
}

Resultado

+02:00
true
+02:00

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes