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.