WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ZoneId — eine Zeitzonenkennung

ZoneId identifiziert eine Zeitzone, während ZoneRules ihre Regeln für den UTC-Versatz beschreibt. Lerne ZoneId.of, ZoneId.getRules und den Unterschied zwischen einer Region und einem festen Versatz kennen.

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

Syntax

ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();

java.time.ZoneId identifiziert eine Zeitzone; ein Datum oder eine Uhrzeit speichert es nicht. ZoneId.of(String) erstellt eine Regionskennung wie Europe/Paris oder eine Kennung für einen festen Versatz wie +02:00. Eine Region ist nicht dasselbe wie ein fester Versatz.

ZoneId.getRules() gibt ZoneRules zurück. Dessen Methode getOffset(Instant) liefert den Versatz für einen bestimmten Zeitpunkt, während isFixedOffset() prüft, ob sich dieser Versatz niemals ändert. Regionsregeln können Zeitumstellungen berücksichtigen und hängen von den in der Laufzeitumgebung verfügbaren Daten ab.

Für ein Instant gilt genau ein Versatz. Bei der Umrechnung eines LocalDateTime kann ein Versatzwechsel jedoch eine Lücke oder eine Überlappung bei den Ortszeiten verursachen. getValidOffsets(LocalDateTime) hilft, solche Fälle zu erkennen. Gehe nicht davon aus, dass eine Ortszeit immer genau einen Zeitpunkt bezeichnet.

Ein ungültiges Format in ZoneId.of führt zu DateTimeException, eine unbekannte Region zu ZoneRulesException. Auch ZoneId.getRules kann ZoneRulesException auslösen, wenn keine Regeln verfügbar sind. Das Beispiel verwendet einen festen Versatz und einen festgelegten Zeitpunkt, damit die Ausgabe weder von der Uhr noch von Aktualisierungen der Regionsdaten abhängt.

Beispiele

import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;

public class Main {
    public static void main(String[] args) {
        ZoneId zone = ZoneId.of("+02:00");
        ZoneRules rules = zone.getRules();
        Instant instant = Instant.parse("2024-01-15T12:00:00Z");

        System.out.println(zone.getId());
        System.out.println(rules.isFixedOffset());
        System.out.println(rules.getOffset(instant));
    }
}

Ergebnis

+02:00
true
+02: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.

Quellen