CKTIS / Java
ZoneOffsetTransition — Lücken und Überlappungen der Ortszeit
ZoneOffsetTransition beschreibt eine Änderung des UTC-Offsets. Die Methode isGap() erkennt eine Lücke, während getDateTimeAfter() die lokale Datumszeit an der Übergangsgrenze mit dem neuen Offset zurückgibt.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
boolean gap = transition.isGap();
LocalDateTime after = transition.getDateTimeAfter();ZoneOffsetTransition modelliert eine Änderung des UTC-Offsets. isGap() gibt bei einer Lücke true zurück: Übersprungene Ortszeiten existieren nicht. Ein Ergebnis von false bedeutet eine Überlappung: Manche Ortszeiten treten zweimal auf.
getDateTimeAfter() gibt die LocalDateTime an der Übergangsgrenze mit dem neuen Offset zurück, kein Instant. Wenn die Uhr zurückgestellt wird, liegt das Ergebnis vor getDateTimeBefore(). Eine Änderung muss nicht eine Stunde betragen.
Anwendungen sollten normalerweise ZoneRules.getTransition(localDateTime) verwenden. Prüfe vor dem Aufruf von Methoden auf null, denn für eine gewöhnliche Ortszeit gibt es keinen Übergang. Das Beispiel verwendet of() nur zur deterministischen Veranschaulichung; diese Factory ist zum Erstellen von ZoneRules gedacht, nicht zum Nachschlagen tatsächlicher Zonenänderungen.
In diesem Eintrag behandelte Referenzbezeichner: ZoneOffsetTransition.isGap, ZoneOffsetTransition.getDateTimeAfter.
Beispiele
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());
}
}Ergebnis
true 2024-03-31T03:00
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.