WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ZonedDateTime — Datum und Uhrzeit mit Zeitzone

ZonedDateTime verbindet ein lokales Datum und eine lokale Uhrzeit mit einer Zeitzone und einem aufgelösten UTC-Offset. Es unterscheidet zwischen einem Zonenwechsel bei gleichbleibendem Zeitpunkt und dem Beibehalten der lokalen Uhrzeit und behandelt Mehrdeutigkeiten bei Zeitumstellungen.

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

Syntax

ZonedDateTime.of(localDateTime, zone)
ZonedDateTime.ofInstant(instant, zone)
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset)
zdt.withZoneSameInstant(zone)
zdt.withZoneSameLocal(zone)
zdt.toInstant()
zdt.format(formatter)
zdt.with(adjuster)
zdt.with(field, value)
zdt.withHour(hour)
zdt.withMinute(minute)

ZonedDateTime ist ein unveränderlicher, threadsicherer ISO-Datums- und Zeitwert mit einer ZoneId und einem ZoneOffset. Eine regionale Zone legt Regeln für Offsetänderungen fest; ein fester Offset kennt solche Änderungen nicht.

ZonedDateTime.of erstellt einen Wert aus einem lokalen Datum mit Uhrzeit und einer Zone. Bei einer Lücke verschiebt es die Uhrzeit um die Länge der Lücke nach vorn; bei einer Überlappung wählt es den früheren Offset. ZonedDateTime.ofLocal akzeptiert zusätzlich einen bevorzugten Offset: Ist er gültig, wird er verwendet, andernfalls der frühere Offset; null bedeutet, dass keine Präferenz besteht. Lücken werden genauso aufgelöst. ZonedDateTime.ofInstant(instant, zone) erhält den angegebenen Zeitpunkt ohne diese Mehrdeutigkeit.

ZonedDateTime.withZoneSameInstant erhält den Zeitpunkt und ändert normalerweise die lokale Uhrzeit. ZonedDateTime.withZoneSameLocal erhält, wenn möglich, das lokale Datum mit Uhrzeit und wendet dabei die Regeln von ofLocal an; der Zeitpunkt kann sich ändern. ZonedDateTime.toInstant gibt nur den Zeitpunkt zurück, ohne die Zonenkennung, während ZonedDateTime.format den Wert mit einem DateTimeFormatter formatiert.

ZonedDateTime.with(adjuster) wendet einen TemporalAdjuster an, während ZonedDateTime.with(field, value) ein Feld setzt. ZonedDateTime.withHour setzt die Stunde auf 0–23 und ZonedDateTime.withMinute die Minute auf 0–59. Verwende den zurückgegebenen Wert: Das Original bleibt unverändert. Lokale Änderungen von Stunde oder Minute folgen ebenfalls den Regeln für Lücken und Überlappungen; sie bedeuten nicht, dass eine Zeitdauer addiert wird.

Beispiele

import java.time.*;
import java.time.format.DateTimeFormatter;

public class Main {
    public static void main(String[] args) {
        ZoneId source = ZoneOffset.ofHours(1);
        ZoneId target = ZoneOffset.ofHours(-5);
        LocalDateTime local = LocalDateTime.of(2024, 1, 15, 12, 0);
        ZonedDateTime original = ZonedDateTime.of(local, source);
        ZonedDateTime sameInstant = original.withZoneSameInstant(target);
        ZonedDateTime sameLocal = original.withZoneSameLocal(target);

        System.out.println(sameInstant.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
        System.out.println(sameLocal.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
        System.out.println(original.toInstant().equals(sameInstant.toInstant()));
        System.out.println(original.toInstant().equals(sameLocal.toInstant()));
    }
}

Ergebnis

2024-01-15T06:00:00-05:00
2024-01-15T12:00:00-05:00
true
false

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.

Quellen