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.