CKTIS / Java
ZoneOffset — ein fester Offset zu UTC
ZoneOffset beschreibt einen festen Offset zu UTC und keine Regeln für eine regionale Zeitzone. ZoneOffset.UTC steht für den Offset null, dessen Kennung Z lautet.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
ZoneOffset.UTC
ZoneOffset.of("+02:00")
ZoneOffset.ofHoursMinutes(-5, -30)
offset.getId()
offset.getTotalSeconds()java.time.ZoneOffset repräsentiert eine feste Abweichung von UTC, zum Beispiel +02:00. Es speichert weder ein Datum noch eine Uhrzeit. Eine regionale ZoneId wie Europe/Paris legt Regeln fest, mit denen sich der Offset für einen bestimmten Zeitpunkt bestimmen lässt; ein Offset allein beschreibt keine Änderungen durch die Sommerzeit.
ZoneOffset.UTC steht für den Offset null; getId() gibt dafür Z zurück. Factory-Methoden wie of("+02:00") und ofHoursMinutes(-5, -30) erzeugen andere Werte. Von null verschiedene Komponenten müssen dasselbe Vorzeichen haben. Der Bereich reicht einschließlich von -18:00 bis +18:00; ein ungültiger Wert löst eine DateTimeException aus.
Instanzen sind unveränderlich und threadsicher. Vergleiche sie mit equals, nicht mit ==, und verwende sie nicht als Synchronisationssperren. Das Beispiel zeigt normalisierte Kennungen, einen Offset in Sekunden und die Gleichheit zweier Darstellungen des Offsets null.
Beispiele
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")));
}
}Ergebnis
Z -05:30 -19800 true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.