KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ZonedDateTime: hetzelfde tijdstip of dezelfde lokale tijd?

Maak in Java 21 een datum en tijd met tijdzone, kies expliciet elk van de twee voorkomens van een herhaald tijdstip en bepaal wat gelijk blijft als je van tijdzone wisselt.

Versie: Java SE 21

Syntax

java.time.ZonedDateTime — Java SE 21

public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)
public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)
public ZonedDateTime withZoneSameInstant(ZoneId zone)
public ZonedDateTime withZoneSameLocal(ZoneId zone)

java.time.ZonedDateTime combineert een lokale datum en tijd met een tijdzone-ID (ZoneId) en een UTC-offset (ZoneOffset). Een Instant is een punt op de tijdlijn. De lokale datum en tijd zijn wat de kalender en klok aangeven; in een bepaalde zone kan die aanduiding bij twee verschillende tijdstippen horen.

ZonedDateTime.of is een statische fabrieksmethode met drie overloads: je geeft een LocalDateTime, een LocalDate en een LocalTime, of zeven numerieke velden op, steeds met een ZoneId. Is er één geldige offset, dan gebruikt de methode die. Bij een overlap, een herhaald lokaal tijdsinterval, kiest ze de offset van de eerste keer. Bij een gat, een overgeslagen lokaal tijdsinterval, schuift ze de lokale datum en tijd vooruit met de duur van het gat en gebruikt ze de offset na de overgang. Ongeldige datum- of tijdvelden in de numerieke overload leiden tot een DateTimeException.

ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) is een statische fabrieksmethode. Bij een overlap gebruikt ze de voorkeurs­offset alleen als die een van de twee geldige offsets is. Bij null of een afwijkende offset kiest ze de eerste keer. Bij één geldige offset of in een gat werkt ze net als of. Een voorkeur is geen validatie: moet je app gaten afwijzen of bij overlaps een expliciete keuze eisen, controleer dan zone.getRules().getValidOffsets(localDateTime). Die methode geeft 0, 1 of 2 offsets terug.

ZonedDateTime.withZoneSameInstant(zone) toont dezelfde gebeurtenis in een andere tijdzone: toInstant() geeft een gelijke waarde terug, ook als de lokale datum of tijd verandert. Je hoeft geen lokaal gat of overlap op te lossen; een resultaat buiten het ondersteunde datumbereik leidt tot een DateTimeException. ZonedDateTime.withZoneSameLocal(zone) behandelt dezelfde datum en kloktijd als lokale tijd in de doelzone, waardoor het tijdstip kan veranderen. De methode volgt de regels van ofLocal met de huidige offset als voorkeur. In een gat kan ze de oorspronkelijke lokale datum en tijd niet behouden. Geen van beide methoden wijzigt het oorspronkelijke object.

Voorbeelden

import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;

public class ZonedDateTimeTransform {
    public static void main(String[] args) {
        ZoneId paris = ZoneId.of("Europe/Paris");
        LocalDateTime wallTime = LocalDateTime.of(2024, 10, 27, 2, 30);

        ZonedDateTime defaultChoice = ZonedDateTime.of(wallTime, paris);
        ZonedDateTime earlier = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(2));
        ZonedDateTime later = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(1));

        System.out.println("of: " + defaultChoice);
        System.out.println("ofLocal +02:00: " + earlier + " -> " + earlier.toInstant());
        System.out.println("ofLocal +01:00: " + later + " -> " + later.toInstant());
        System.out.println("same instant: " + earlier.withZoneSameInstant(ZoneOffset.UTC));
        System.out.println("same local: " + earlier.withZoneSameLocal(ZoneOffset.UTC));
    }
}

Resultaat

of: 2024-10-27T02:30+02:00[Europe/Paris]
ofLocal +02:00: 2024-10-27T02:30+02:00[Europe/Paris] -> 2024-10-27T00:30:00Z
ofLocal +01:00: 2024-10-27T02:30+01:00[Europe/Paris] -> 2024-10-27T01:30:00Z
same instant: 2024-10-27T00:30Z
same local: 2024-10-27T02:30Z

Volgens de regels voor `Europe/Paris` in het voorbeeld komt `02:30` twee keer voor: `+02:00` geeft `00:30Z` en `+01:00` geeft `01:30Z`. `of` kiest de eerste keer; de twee aanroepen van `ofLocal` kiezen beide offsets expliciet. Zet je de eerste keer om naar UTC, dan krijg je `00:30Z` als je het tijdstip behoudt of `02:30Z` als je de kloktijd behoudt. Uitkomsten voor een regionale tijdzone hangen af van de regels die de runtime beschikbaar heeft.

Gerelateerde lessen

  • Java · Les 60 · Gevorderd · Versie: 2

Bronnen