CKTIS / Java
ZoneOffsetTransition — huecos y solapamientos de la hora local
ZoneOffsetTransition describe un cambio en el desfase UTC. El método isGap() identifica un hueco, mientras que getDateTimeAfter() devuelve la fecha y hora local en el límite de la transición usando el nuevo desfase.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
boolean gap = transition.isGap();
LocalDateTime after = transition.getDateTimeAfter();ZoneOffsetTransition modela un cambio en el desfase UTC. isGap() devuelve true si hay un hueco: las horas locales omitidas no existen. Un resultado false significa que hay un solapamiento: algunas horas locales se producen dos veces.
getDateTimeAfter() devuelve el LocalDateTime del límite de la transición usando el nuevo desfase, no un Instant. Cuando el reloj se retrasa, el resultado es anterior a getDateTimeBefore(). El cambio no tiene por qué ser de una hora.
Normalmente, las aplicaciones deberían usar ZoneRules.getTransition(localDateTime); comprueba si el valor es null antes de llamar a métodos, porque una hora local normal no tiene transición. El ejemplo usa of() solo como demostración determinista; esa factoría está pensada para construir ZoneRules, no para buscar cambios reales de zona horaria.
Identificadores de referencia incluidos en esta entrada: ZoneOffsetTransition.isGap, ZoneOffsetTransition.getDateTimeAfter.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.