Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ZoneId — identyfikator strefy czasowej

ZoneId identyfikuje strefę czasową, a ZoneRules opisuje jej reguły przesunięcia względem UTC. Poznaj ZoneId.of, ZoneId.getRules oraz różnicę między regionem a stałym przesunięciem.

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

Składnia

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

java.time.ZoneId identyfikuje strefę czasową; nie przechowuje daty ani godziny. ZoneId.of(String) tworzy identyfikator regionu, np. Europe/Paris, lub stałego przesunięcia, np. +02:00. Region nie jest tym samym co stałe przesunięcie.

ZoneId.getRules() zwraca ZoneRules. Metoda getOffset(Instant) tych reguł podaje przesunięcie dla konkretnej chwili, a isFixedOffset() sprawdza, czy nigdy się ono nie zmienia. Reguły regionu mogą uwzględniać zmiany czasu i zależą od danych dostępnych w środowisku uruchomieniowym.

Dla Instant istnieje jedno właściwe przesunięcie. Przy przeliczaniu LocalDateTime przejście między przesunięciami może jednak powodować lukę albo nałożenie godzin. getValidOffsets(LocalDateTime) pozwala rozpoznać takie przypadki; nie zakładaj, że lokalna godzina zawsze wskazuje jedną chwilę.

Niepoprawny format w ZoneId.of powoduje DateTimeException, a nieznany region — ZoneRulesException. ZoneId.getRules również może zgłosić ZoneRulesException, gdy brakuje reguł. Przykład używa stałego przesunięcia i ustalonej chwili, aby wynik nie zależał od zegara ani aktualizacji danych regionalnych.

Przykłady

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

Wynik

+02:00
true
+02:00

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła