WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ZoneId.of und ZoneId.getRules: Zeitzonenregeln

Ermittle die UTC-Abweichungen in Warschau und New York zum selben Zeitpunkt im Jahr 2025 und sieh, warum eine feste Abweichung keine regionale Zeitzone ersetzt.

Version: Java SE 21

Syntax

java.time.ZoneId
  public static ZoneId of(String zoneId)
  public static ZoneId of(String zoneId, java.util.Map<String, String> aliasMap)
  public abstract java.time.zone.ZoneRules getRules()

Die statische Fabrikmethode ZoneId.of(String) aus java.time prüft eine ID und gibt eine ZoneId zurück. Europe/Warsaw und America/New_York bezeichnen regionale Zeitzonen; +01:00 ergibt einen ZoneOffset, also eine feste Abweichung von UTC. Gleiche Abweichungen zu einem Zeitpunkt bedeuten nicht, dass die Regeln gleich sind.

Mit der Überladung ZoneId.of(String, Map<String, String>) kannst du Aliasse selbst Zeitzonen-IDs zuordnen. Verwende regionale IDs statt mehrdeutiger Abkürzungen. Ein ungültiges Format führt zu einer DateTimeException, eine korrekt formatierte, aber unbekannte regionale ID zu einer ZoneRulesException, einem Untertyp von DateTimeException.

Die Instanzmethode ZoneId.getRules() gibt ein unveränderliches java.time.zone.ZoneRules-Objekt zurück. getOffset(Instant) liefert die einzige zu diesem Zeitpunkt gültige Abweichung. Verwende bei LocalDateTime die Methode getValidOffsets: Sie liefert keine Abweichung in der Lücke beim Vorstellen der Uhr, eine außerhalb eines Übergangs und normalerweise zwei im wiederholten Intervall beim Zurückstellen. Wird die Uhr zweimal kurz hintereinander zurückgestellt, sind theoretisch mehr als zwei gültige Abweichungen möglich. In einer Lücke oder Überlappung liefert getOffset(LocalDateTime) die Abweichung vor dem Übergang; in einer Lücke ist sie für die angegebene Ortszeit nicht gültig.

Regionale Regeln stammen von einem ZoneRulesProvider, standardmäßig aus der IANA TZDB. Historische Ergebnisse hängen von den Daten der Laufzeitumgebung ab. Ein Anbieter mit dynamischen Aktualisierungen kann bei einem späteren Aufruf von getRules() andere Regeln liefern. Sind die Regeln nach der Deserialisierung einer ID nicht verfügbar, löst getRules() eine ZoneRulesException aus.

Beispiele

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

public class Main {
    public static void main(String[] args) {
        ZoneRules warsaw = ZoneId.of("Europe/Warsaw").getRules();
        ZoneRules newYork = ZoneId.of("America/New_York").getRules();
        ZoneRules fixed = ZoneId.of("+01:00").getRules();

        System.out.println("UTC instant | Europe/Warsaw | America/New_York | fixed +01:00");
        for (String timestamp : new String[] {
                "2025-03-01T12:00:00Z", "2025-03-15T12:00:00Z", "2025-04-01T12:00:00Z"
        }) {
            Instant instant = Instant.parse(timestamp);
            System.out.println(instant + " | " + warsaw.getOffset(instant)
                    + " | " + newYork.getOffset(instant) + " | " + fixed.getOffset(instant));
        }
    }
}

Ergebnis

UTC instant | Europe/Warsaw | America/New_York | fixed +01:00
2025-03-01T12:00:00Z | +01:00 | -05:00 | +01:00
2025-03-15T12:00:00Z | +01:00 | -04:00 | +01:00
2025-04-01T12:00:00Z | +02:00 | -04:00 | +01:00

Jede Zeile vergleicht denselben UTC-Zeitpunkt. Am 15. März 2025 gilt in New York bereits die Sommerzeit, in Warschau noch nicht. Bis zum 1. April hat sich auch die Warschauer Abweichung geändert; das feste `+01:00` bleibt gleich.

Zugehörige Lektionen

  • Java · Lektion 60 · Fortgeschritten · Version: 2

Quellen