Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ZoneId.of i ZoneId.getRules: reguły stref czasowych

Sprawdź, jakie przesunięcie względem UTC obowiązywało w Warszawie i Nowym Jorku w tej samej chwili w 2025 roku i dlaczego stałe przesunięcie nie zastąpi strefy regionalnej.

Wersja: Java SE 21

Składnia

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()

Statyczna metoda ZoneId.of(String) z pakietu java.time sprawdza identyfikator i zwraca ZoneId. Europe/Warsaw i America/New_York wskazują strefy regionalne, a +01:00 daje ZoneOffset, czyli stałe przesunięcie względem UTC. Zgodność przesunięć w jednej chwili nie oznacza, że reguły są takie same.

Przeciążenie ZoneId.of(String, Map<String, String>) pozwala podać własną mapę aliasów, które wskazują identyfikatory stref. Zamiast polegać na niejednoznacznych skrótach, używaj identyfikatorów regionalnych. Niepoprawny format powoduje DateTimeException, a poprawnie zapisany, lecz nieznany identyfikator regionalny powoduje ZoneRulesException (podtyp DateTimeException).

Metoda instancji ZoneId.getRules() zwraca niemutowalny java.time.zone.ZoneRules. getOffset(Instant) zwraca jedno przesunięcie obowiązujące w danej chwili. Dla LocalDateTime użyj getValidOffsets: lista zawiera zero wartości w luce po przestawieniu zegara do przodu, jedną poza przejściem i zwykle dwie w powtórzonym przedziale po cofnięciu zegara. Teoretycznie poprawnych przesunięć może być więcej niż dwa, jeśli zegar zostanie cofnięty dwukrotnie w krótkim odstępie czasu. W luce i w powtórzonym przedziale getOffset(LocalDateTime) zwraca przesunięcie sprzed przejścia, które w luce nie jest poprawne dla podanego czasu lokalnego.

Reguły regionalne dostarcza ZoneRulesProvider; domyślne dane pochodzą z IANA TZDB. Wyniki historyczne zależą od danych środowiska uruchomieniowego. Dostawca obsługujący aktualizacje dynamiczne może zwrócić inne reguły przy późniejszym wywołaniu getRules(). Jeśli po deserializacji identyfikatora brakuje jego reguł, getRules() zgłasza ZoneRulesException.

Przykłady

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));
        }
    }
}

Wynik

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

W każdym wierszu porównujesz tę samą chwilę UTC. 15 marca 2025 w Nowym Jorku obowiązuje już czas letni, a w Warszawie jeszcze nie. Do 1 kwietnia Warszawa też zmienia przesunięcie; stałe `+01:00` pozostaje bez zmian.

Powiązane lekcje

  • Java · Lekcja 60 · Zaawansowany · Wersja: 2

Źródła