KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ZoneId — een tijdzone-identificatie

ZoneId identificeert een tijdzone, terwijl ZoneRules de regels voor de UTC-verschuiving beschrijft. Leer over ZoneId.of, ZoneId.getRules en het verschil tussen een regio en een vaste verschuiving.

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

Syntax

ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();

java.time.ZoneId identificeert een tijdzone; het slaat geen datum of tijd op. ZoneId.of(String) maakt een regio-identificatie, zoals Europe/Paris, of een identificatie voor een vaste verschuiving, zoals +02:00. Een regio is niet hetzelfde als een vaste verschuiving.

ZoneId.getRules() geeft ZoneRules terug. De methode getOffset(Instant) daarvan levert de verschuiving voor een bepaald tijdstip, terwijl isFixedOffset() controleert of die verschuiving nooit verandert. Regionale regels kunnen klokveranderingen bevatten en zijn afhankelijk van de gegevens die in de runtime beschikbaar zijn.

Voor een Instant geldt één toepasselijke verschuiving. Bij het omzetten van een LocalDateTime kan een verschuivingsovergang echter een gat of overlap in lokale tijden veroorzaken. getValidOffsets(LocalDateTime) helpt zulke gevallen te herkennen; ga er niet van uit dat een lokale tijd altijd één tijdstip aanduidt.

Een ongeldig formaat dat aan ZoneId.of wordt doorgegeven, veroorzaakt DateTimeException; een onbekende regio veroorzaakt ZoneRulesException. Ook ZoneId.getRules kan ZoneRulesException veroorzaken als er geen regels beschikbaar zijn. Het voorbeeld gebruikt een vaste verschuiving en een vastgelegd tijdstip, zodat de uitvoer niet afhankelijk is van de klok of updates van regionale gegevens.

Voorbeelden

import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;

public class Main {
    public static void main(String[] args) {
        ZoneId zone = ZoneId.of("+02:00");
        ZoneRules rules = zone.getRules();
        Instant instant = Instant.parse("2024-01-15T12:00:00Z");

        System.out.println(zone.getId());
        System.out.println(rules.isFixedOffset());
        System.out.println(rules.getOffset(instant));
    }
}

Resultaat

+02:00
true
+02:00

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