Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti