Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ZoneOffset — stałe przesunięcie względem UTC

ZoneOffset opisuje stałe przesunięcie względem UTC, a nie reguły regionalnej strefy czasowej. ZoneOffset.UTC oznacza przesunięcie zerowe, którego identyfikatorem jest Z.

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

Składnia

ZoneOffset.UTC
ZoneOffset.of("+02:00")
ZoneOffset.ofHoursMinutes(-5, -30)
offset.getId()
offset.getTotalSeconds()

java.time.ZoneOffset reprezentuje stałą różnicę względem UTC, na przykład +02:00. Nie przechowuje daty ani godziny. Regionalny ZoneId, taki jak Europe/Paris, określa reguły pozwalające wyznaczyć przesunięcie dla danego momentu; sam offset nie opisuje zmian czasu letniego.

ZoneOffset.UTC oznacza przesunięcie zerowe; getId() zwraca dla niego Z. Fabryki takie jak of("+02:00") i ofHoursMinutes(-5, -30) tworzą inne wartości. Niezerowe składowe muszą mieć zgodne znaki. Zakres wynosi od -18:00 do +18:00 włącznie; niepoprawna wartość powoduje DateTimeException.

Obiekty są niezmienne i bezpieczne wątkowo. Porównuj je przez equals, nie przez ==, i nie używaj ich jako blokad synchronizacji. Przykład pokazuje znormalizowane identyfikatory, przesunięcie w sekundach oraz równość dwóch zapisów zerowego przesunięcia.

Przykłady

import java.time.ZoneOffset;

public class Main {
    public static void main(String[] args) {
        ZoneOffset offset = ZoneOffset.ofHoursMinutes(-5, -30);
        System.out.println(ZoneOffset.UTC.getId());
        System.out.println(offset.getId());
        System.out.println(offset.getTotalSeconds());
        System.out.println(ZoneOffset.UTC.equals(ZoneOffset.of("+00:00")));
    }
}

Wynik

Z
-05:30
-19800
true

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

Źródła