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.