CKTIS / Java
ZoneRules — gültige Offsets und Zeitumstellungen
ZoneRules beschreibt Änderungen des Offsets einer Zeitzone. Mit getValidOffsets und getTransition lassen sich nicht existierende oder mehrdeutige lokale Zeiten erkennen, bevor ein Offset ausgewählt wird.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);ZoneRules beschreibt die Offset-Regeln einer Zeitzone. ZoneRules.getValidOffsets(LocalDateTime) gibt bei einer Lücke eine leere Liste, normalerweise einen Eintrag und bei einer Überlappung zwei Einträge zurück. Bei einer Überlappung steht der Offset vor der Umstellung an erster Stelle; theoretisch sind mehr als zwei Offsets möglich.
ZoneRules.getTransition(LocalDateTime) gibt bei einer Lücke oder Überlappung eine ZoneOffsetTransition zurück, andernfalls null. Werden die Uhren vorgestellt, entstehen nicht existierende lokale Zeiten; beim Zurückstellen entstehen Zeiten, die zweimal vorkommen. isGap() und isOverlap() unterscheiden diese Fälle. Gehe nicht davon aus, dass eine Umstellung eine Stunde dauert.
Lege eine klare Vorgehensweise fest: Lehne eine Lücke ab oder passe die Zeit an; wähle bei einer Überlappung bewusst einen Offset. getOffset(LocalDateTime) allein prüft die Zeit nicht: Bei Lücken und Überlappungen gibt die Methode den Offset vor der Umstellung zurück.
Beispiele
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);
}
}Ergebnis
[] true [+02:00] true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.