CKTIS / Java
ZonedDateTime — datum en tijd met tijdzone
ZonedDateTime combineert een lokale datum en tijd, een zone en een opgeloste UTC-offset. Het maakt onderscheid tussen van zone veranderen met behoud van het moment en het behouden van de lokale kloktijd, en verwerkt ambiguïteit door klokveranderingen.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
ZonedDateTime.of(localDateTime, zone)
ZonedDateTime.ofInstant(instant, zone)
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset)
zdt.withZoneSameInstant(zone)
zdt.withZoneSameLocal(zone)
zdt.toInstant()
zdt.format(formatter)
zdt.with(adjuster)
zdt.with(field, value)
zdt.withHour(hour)
zdt.withMinute(minute)ZonedDateTime is een onveranderlijke, threadveilige ISO-datum-tijd met een ZoneId en een ZoneOffset. Een regionale zone bepaalt regels voor offsetveranderingen; een vaste offset kent zulke veranderingen niet.
ZonedDateTime.of maakt een waarde uit een lokale datum-tijd en een zone. Bij een tijdsgat schuift het de tijd vooruit met de lengte van het gat; bij een overlap kiest het de eerdere offset. ZonedDateTime.ofLocal accepteert ook een voorkeurs-offset: die wordt gebruikt als hij geldig is, anders wordt de eerdere offset gekozen; null betekent dat er geen voorkeur is. Tijdsgaten worden op dezelfde manier opgelost. ZonedDateTime.ofInstant(instant, zone) behoudt het opgegeven moment zonder deze ambiguïteit.
ZonedDateTime.withZoneSameInstant behoudt het moment en verandert doorgaans de lokale kloktijd. ZonedDateTime.withZoneSameLocal behoudt, indien mogelijk, de lokale datum-tijd en past daarbij de regels van ofLocal toe; het moment kan veranderen. ZonedDateTime.toInstant geeft alleen het moment terug, zonder de zone-id, terwijl ZonedDateTime.format de waarde opmaakt met een DateTimeFormatter.
ZonedDateTime.with(adjuster) past een TemporalAdjuster toe, terwijl ZonedDateTime.with(field, value) een veld instelt. ZonedDateTime.withHour stelt het uur in op 0–23 en ZonedDateTime.withMinute de minuut op 0–59. Gebruik de teruggegeven waarde: het origineel blijft ongewijzigd. Lokale veranderingen van uur of minuut volgen ook de regels voor tijdsgaten en overlaps; ze betekenen niet dat er een verstreken tijdsduur wordt opgeteld.
Voorbeelden
import java.time.*;
import java.time.format.DateTimeFormatter;
public class Main {
public static void main(String[] args) {
ZoneId source = ZoneOffset.ofHours(1);
ZoneId target = ZoneOffset.ofHours(-5);
LocalDateTime local = LocalDateTime.of(2024, 1, 15, 12, 0);
ZonedDateTime original = ZonedDateTime.of(local, source);
ZonedDateTime sameInstant = original.withZoneSameInstant(target);
ZonedDateTime sameLocal = original.withZoneSameLocal(target);
System.out.println(sameInstant.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
System.out.println(sameLocal.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
System.out.println(original.toInstant().equals(sameInstant.toInstant()));
System.out.println(original.toInstant().equals(sameLocal.toInstant()));
}
}Resultaat
2024-01-15T06:00:00-05:00 2024-01-15T12:00:00-05:00 true false
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.