CKTIS / Java
ZoneOffsetTransition — lacune e sovrapposizioni dell’ora locale
ZoneOffsetTransition descrive una modifica dell’offset UTC. Il metodo isGap() identifica una lacuna, mentre getDateTimeAfter() restituisce la data e l’ora locali al limite della transizione usando il nuovo offset.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
boolean gap = transition.isGap();
LocalDateTime after = transition.getDateTimeAfter();ZoneOffsetTransition modella una modifica dell’offset UTC. isGap() restituisce true in presenza di una lacuna: gli orari locali saltati non esistono. Un risultato false indica una sovrapposizione: alcuni orari locali si verificano due volte.
getDateTimeAfter() restituisce il LocalDateTime al limite della transizione usando il nuovo offset, non un Instant. Quando l’orologio viene spostato indietro, il risultato è precedente a getDateTimeBefore(). La modifica non deve necessariamente essere di un’ora.
Di norma, le applicazioni dovrebbero usare ZoneRules.getTransition(localDateTime); controlla che il valore non sia null prima di chiamare i metodi, perché un normale orario locale non ha una transizione. L’esempio usa of() solo come dimostrazione deterministica; questa factory serve a creare ZoneRules, non a cercare cambiamenti reali di fuso orario.
Identificatori di riferimento trattati in questa voce: ZoneOffsetTransition.isGap, ZoneOffsetTransition.getDateTimeAfter.
Esempi
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());
}
}Risultato
true 2024-03-31T03:00
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.