Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ZoneRules — offset validi e cambi dell’orologio

ZoneRules descrive i cambiamenti dell’offset di una zona. I metodi getValidOffsets e getTransition rilevano gli orari locali inesistenti o ambigui prima che venga scelto un offset.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);

ZoneRules descrive le regole degli offset di una zona. ZoneRules.getValidOffsets(LocalDateTime) restituisce una lista vuota in caso di intervallo inesistente, normalmente un elemento oppure due in caso di sovrapposizione. In una sovrapposizione, l’offset precedente alla transizione compare per primo; teoricamente sono possibili più di due offset.

ZoneRules.getTransition(LocalDateTime) restituisce una ZoneOffsetTransition in caso di intervallo inesistente o sovrapposizione, altrimenti null. Spostare gli orologi in avanti crea orari locali inesistenti; spostarli indietro crea orari che si verificano due volte. isGap() e isOverlap() distinguono questi casi. Non presumere che una transizione duri un’ora.

Definisci una politica esplicita: rifiuta un intervallo inesistente oppure correggi l’orario; in caso di sovrapposizione, scegli consapevolmente un offset. getOffset(LocalDateTime) da solo non convalida l’orario: in caso di intervallo inesistente o sovrapposizione restituisce l’offset precedente alla transizione.

Esempi

import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.zone.ZoneOffsetTransition;
import java.time.zone.ZoneRules;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        ZoneOffset before = ZoneOffset.ofHours(1);
        ZoneOffset after = ZoneOffset.ofHours(2);
        ZoneOffsetTransition jump = ZoneOffsetTransition.of(
                LocalDateTime.of(2024, 3, 31, 2, 0), before, after);
        ZoneRules rules = ZoneRules.of(
                before, before, List.of(), List.of(jump), List.of());

        LocalDateTime local = LocalDateTime.of(2024, 3, 31, 2, 30);
        System.out.println(rules.getValidOffsets(local));
        ZoneOffsetTransition transition = rules.getTransition(local);
        System.out.println(transition != null && transition.isGap());
        System.out.println(rules.getValidOffsets(local.plusHours(1)));
        System.out.println(rules.getTransition(local.plusHours(1)) == null);
    }
}

Risultato

[]
true
[+02:00]
true

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