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

CKTIS / Java

ZoneOffsetTransition — lacunas e sobreposições da hora local

ZoneOffsetTransition descreve uma alteração do desvio UTC. O método isGap() identifica uma lacuna, enquanto getDateTimeAfter() devolve a data e hora locais no limite da transição, usando o novo desvio.

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

Sintaxe

boolean gap = transition.isGap();
LocalDateTime after = transition.getDateTimeAfter();

ZoneOffsetTransition modela uma alteração do desvio UTC. isGap() devolve true quando existe uma lacuna: as horas locais omitidas não existem. Um resultado false significa que existe uma sobreposição: algumas horas locais ocorrem duas vezes.

getDateTimeAfter() devolve o LocalDateTime no limite da transição, usando o novo desvio, e não um Instant. Quando o relógio é atrasado, o resultado é anterior a getDateTimeBefore(). A alteração não tem necessariamente a duração de uma hora.

Em geral, as aplicações devem usar ZoneRules.getTransition(localDateTime); verifique se o valor é null antes de chamar métodos, porque uma hora local normal não tem uma transição. O exemplo usa of() apenas como demonstração determinística; essa fábrica destina-se a criar ZoneRules, não a procurar alterações reais de fuso horário.

Identificadores de referência abrangidos por esta entrada: ZoneOffsetTransition.isGap, ZoneOffsetTransition.getDateTimeAfter.

Exemplos

import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.zone.ZoneOffsetTransition;

public class Main {
    public static void main(String[] args) {
        ZoneOffsetTransition transition = ZoneOffsetTransition.of(
            LocalDateTime.of(2024, 3, 31, 2, 0),
            ZoneOffset.ofHours(1),
            ZoneOffset.ofHours(2)
        );
        System.out.println(transition.isGap());
        System.out.println(transition.getDateTimeAfter());
    }
}

Resultado

true
2024-03-31T03: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