WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen