KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ZoneOffset — een vaste offset ten opzichte van UTC

ZoneOffset beschrijft een vaste offset ten opzichte van UTC, niet de regels van een regionale tijdzone. ZoneOffset.UTC staat voor de nul-offset, met Z als identificatie.

Versie: 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 vertegenwoordigt een vast verschil ten opzichte van UTC, bijvoorbeeld +02:00. Het slaat geen datum en geen tijd op. Een regionale ZoneId, zoals Europe/Paris, bepaalt de regels om de offset op een bepaald moment te vinden; een offset op zichzelf beschrijft geen veranderingen door zomertijd.

ZoneOffset.UTC staat voor de nul-offset; getId() geeft daarvoor Z terug. Fabriekmethoden zoals of("+02:00") en ofHoursMinutes(-5, -30) maken andere waarden aan. Niet-nulcomponenten moeten hetzelfde teken hebben. Het bereik loopt inclusief van -18:00 tot +18:00; een ongeldige waarde veroorzaakt een DateTimeException.

Instanties zijn onveranderlijk en thread-safe. Vergelijk ze met equals, niet met ==, en gebruik ze niet als synchronisatievergrendeling. Het voorbeeld toont genormaliseerde identificaties, een offset in seconden en de gelijkheid van twee schrijfwijzen voor de nul-offset.

Voorbeelden

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")));
    }
}

Resultaat

Z
-05:30
-19800
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen