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.