CKTIS / Java
ZonedDateTime: Derselbe Zeitpunkt oder dieselbe Ortszeit?
Erzeuge in Java 21 ein Datum mit Uhrzeit und Zeitzone, wähle bei einer wiederholten Ortszeit gezielt eines der beiden Vorkommen und entscheide beim Zonenwechsel, was erhalten bleiben soll.
Version: Java SE 21
Syntax
java.time.ZonedDateTime — Java SE 21
public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)
public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)
public ZonedDateTime withZoneSameInstant(ZoneId zone)
public ZonedDateTime withZoneSameLocal(ZoneId zone)java.time.ZonedDateTime verbindet lokales Datum und lokale Uhrzeit mit einer Zeitzonen-ID (ZoneId) und einem UTC-Offset (ZoneOffset). Ein Instant ist ein Punkt auf der Zeitachse. Lokales Datum und lokale Uhrzeit zeigen an, was Kalender und Uhr anzeigen; in einer Zone kann diese Angabe zwei verschiedene Zeitpunkte bezeichnen.
ZonedDateTime.of ist eine statische Fabrikmethode mit drei Überladungen: Sie nimmt ein LocalDateTime, ein LocalDate und ein LocalTime oder sieben numerische Felder entgegen, jeweils mit einer ZoneId. Gibt es genau einen gültigen Offset, wird er verwendet. Bei einer Überlappung, also einem wiederholten lokalen Zeitabschnitt, gilt der Offset des ersten Vorkommens. In einer Zeitlücke wird die Ortszeit um die Dauer der Lücke nach vorne verschoben und der Offset nach der Umstellung verwendet. Ungültige Datums- oder Uhrzeitfelder in der numerischen Überladung führen zu DateTimeException.
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) ist eine statische Fabrikmethode. Bei einer Überlappung übernimmt sie den bevorzugten Offset nur, wenn er einer der beiden gültigen Offsets ist. Bei null oder einem nicht passenden Offset wählt sie das erste Vorkommen. Bei einem einzigen gültigen Offset oder in einer Lücke verhält sie sich wie of. Eine Präferenz ist keine Validierung: Soll die Anwendung Lücken ablehnen oder bei Überlappungen eine ausdrückliche Wahl verlangen, prüfe zone.getRules().getValidOffsets(localDateTime). Die Methode liefert 0, 1 oder 2 Offsets.
ZonedDateTime.withZoneSameInstant(zone) zeigt dasselbe Ereignis in einer anderen Zone: Der Wert von toInstant() bleibt gleich, auch wenn sich lokales Datum oder Uhrzeit ändern. Eine lokale Lücke oder Überlappung muss dabei nicht aufgelöst werden; ein Ergebnis außerhalb des unterstützten Datumsbereichs führt zu DateTimeException. ZonedDateTime.withZoneSameLocal(zone) deutet dasselbe Datum und dieselbe Uhrzeit als Ortszeit der Zielzone, sodass sich der Zeitpunkt ändern kann. Es gelten die Regeln von ofLocal mit dem bisherigen Offset als Präferenz. In einer Lücke bleibt die ursprüngliche Ortszeit nicht erhalten. Keine der Methoden verändert das Ausgangsobjekt.
Beispiele
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
public class ZonedDateTimeTransform {
public static void main(String[] args) {
ZoneId paris = ZoneId.of("Europe/Paris");
LocalDateTime wallTime = LocalDateTime.of(2024, 10, 27, 2, 30);
ZonedDateTime defaultChoice = ZonedDateTime.of(wallTime, paris);
ZonedDateTime earlier = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(2));
ZonedDateTime later = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(1));
System.out.println("of: " + defaultChoice);
System.out.println("ofLocal +02:00: " + earlier + " -> " + earlier.toInstant());
System.out.println("ofLocal +01:00: " + later + " -> " + later.toInstant());
System.out.println("same instant: " + earlier.withZoneSameInstant(ZoneOffset.UTC));
System.out.println("same local: " + earlier.withZoneSameLocal(ZoneOffset.UTC));
}
}Ergebnis
of: 2024-10-27T02:30+02:00[Europe/Paris] ofLocal +02:00: 2024-10-27T02:30+02:00[Europe/Paris] -> 2024-10-27T00:30:00Z ofLocal +01:00: 2024-10-27T02:30+01:00[Europe/Paris] -> 2024-10-27T01:30:00Z same instant: 2024-10-27T00:30Z same local: 2024-10-27T02:30Z
Nach den im Beispiel verwendeten Regeln für `Europe/Paris` tritt `02:30` zweimal auf: Mit `+02:00` ergibt sich `00:30Z`, mit `+01:00` ergibt sich `01:30Z`. `of` wählt das erste Vorkommen; die beiden Aufrufe von `ofLocal` wählen die Offsets ausdrücklich. Beim Wechsel vom ersten Vorkommen zu UTC ergibt sich `00:30Z`, wenn der Zeitpunkt erhalten bleibt, oder `02:30Z`, wenn die Uhrzeit erhalten bleibt. Ergebnisse für regionale Zonen hängen von den Regeln der Laufzeitumgebung ab.
Zugehörige Lektionen
- Java · Lektion 60 · Fortgeschritten · Version: 2