KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ZonedDateTime: maken, omrekenen, opmaken en kalendervelden wijzigen

Maak een datum en tijd met tijdzone, reken die om zonder het tijdstip te veranderen, maak de uitvoer op en wijzig lokale velden met oog voor klokwisselingen.

Versie: Java SE 21

Syntax

java.time.ZonedDateTime — Java SE 21
static ZonedDateTime of(LocalDateTime dateTime, ZoneId zone)
static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
static ZonedDateTime ofInstant(Instant instant, ZoneId zone)
static ZonedDateTime ofInstant(LocalDateTime dateTime, ZoneOffset offset, ZoneId zone)
Instant toInstant() // inherited from ChronoZonedDateTime
ZonedDateTime withZoneSameInstant(ZoneId zone)
String format(DateTimeFormatter formatter)
ZonedDateTime with(TemporalAdjuster adjuster)
ZonedDateTime with(TemporalField field, long newValue)
ZonedDateTime withHour(int hour)
ZonedDateTime withMinute(int minute)

java.time.ZonedDateTime bewaart een lokale datum en tijd, een zone-ID en de bepaalde afwijking ten opzichte van UTC. De statische methode ZonedDateTime.of accepteert een LocalDateTime, een combinatie van LocalDate en LocalTime of zeven gehele getallen (year tot en met nanoOfSecond), telkens met een ZoneId. Valt de lokale tijd in een overgeslagen interval doordat de klok vooruitgaat, dan schuift de methode de lokale datum en tijd op met de lengte van dat interval. Komt de lokale tijd twee keer voor, dan kiest de methode de UTC-afwijking die bij het vroegste tijdstip hoort. Ongeldige numerieke velden of een onmogelijke datum leiden tot DateTimeException.

ZonedDateTime.ofInstant(Instant, ZoneId) bepaalt de lokale datum, tijd en UTC-afwijking voor het gegeven tijdstip in de doelzone. De overload (LocalDateTime, ZoneOffset, ZoneId) bepaalt eerst het tijdstip uit de opgegeven lokale datum en tijd en UTC-afwijking, en geeft het vervolgens weer in de doelzone. Zowel de lokale tijd als de UTC-afwijking kan daardoor afwijken van de invoer. De overgeërfde methode ZonedDateTime.toInstant() geeft hetzelfde tijdstip terug zonder zone-informatie. ZonedDateTime.withZoneSameInstant(ZoneId) behoudt het tijdstip, maar kan de lokale datum en tijd veranderen. withZoneSameLocal probeert juist de lokale datum en tijd te behouden en kan het tijdstip veranderen.

ZonedDateTime.format(DateTimeFormatter) geeft een String terug zonder het object te wijzigen. ISO_OFFSET_DATE_TIME toont de lokale datum, tijd en UTC-afwijking, maar geen regionale zone-ID. Als de opmaak mislukt, werpt de methode DateTimeException op.

ZonedDateTime.with(TemporalAdjuster) past een regel toe, zoals TemporalAdjusters.lastDayOfMonth(). De overload with(TemporalField, long) stelt een ondersteund veld in, zoals ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS stelt de seconde op de tijdlijn in en behoudt de zone en de fractie van de seconde. OFFSET_SECONDS kan alleen bij een herhaalde lokale tijd naar de andere geldige UTC-afwijking overschakelen. Een niet-ondersteund veld kan leiden tot UnsupportedTemporalTypeException; een ongeldige waarde kan leiden tot DateTimeException.

ZonedDateTime.withHour(int) stelt het uur (0–23) in en ZonedDateTime.withMinute(int) de minuut (0–59); geen van beide telt verstreken tijd op. Waarden buiten het bereik leiden tot DateTimeException. Bij wijziging van lokale velden blijft de zone gelijk, maar kan het tijdstip veranderen. In een overgeslagen interval schuift het resultaat op met de lengte van dat interval. Bij een herhaalde tijd blijft de vorige UTC-afwijking behouden als die geldig is; anders wordt het vroegste tijdstip gekozen. De objecten zijn onveranderlijk, dus bewaar het teruggegeven resultaat.

Voorbeelden

import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        ZoneOffset east = ZoneOffset.of("+01:00");
        ZoneOffset west = ZoneOffset.of("-05:00");
        DateTimeFormatter iso = DateTimeFormatter.ISO_OFFSET_DATE_TIME;

        ZonedDateTime original = ZonedDateTime.of(
                LocalDateTime.of(2024, 1, 15, 10, 30), east);
        Instant instant = original.toInstant();
        ZonedDateTime converted = original.withZoneSameInstant(west);
        ZonedDateTime rebuilt = ZonedDateTime.ofInstant(instant, west);
        ZonedDateTime edited = original.with(ChronoField.MONTH_OF_YEAR, 2)
                .with(TemporalAdjusters.lastDayOfMonth())
                .withHour(14)
                .withMinute(45);

        System.out.println(original.format(iso));
        System.out.println(instant);
        System.out.println(converted.format(iso));
        System.out.println(converted.equals(rebuilt));
        System.out.println(edited.format(iso));
    }
}

Resultaat

2024-01-15T10:30:00+01:00
2024-01-15T09:30:00Z
2024-01-15T04:30:00-05:00
true
2024-02-29T14:45:00+01:00

De eerste drie regels geven hetzelfde tijdstip weer. `true` laat zien dat beide omzettingen naar `-05:00` overeenkomen. De laatste regel toont de kalenderwijziging naar 29 februari om 14:45 met de oorspronkelijke UTC-afwijking. Met vaste UTC-afwijkingen hangt het voorbeeld niet af van regionale tijdzoneregels.

Gerelateerde lessen

  • Java · Les 59 · Gemiddeld · Versie: 2

Bronnen