CKTIS / Java
ZonedDateTime — datum i vrijeme s vremenskom zonom
ZonedDateTime objedinjuje lokalni datum i vrijeme, vremensku zonu i razriješeni pomak od UTC-a. Razlikuje promjenu zone uz očuvanje trenutka od očuvanja lokalnog vremena te obrađuje nejasnoće uzrokovane promjenama sata.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
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 je nepromjenjiva i sigurna za rad s više dretvi ISO vrijednost datuma i vremena s ZoneId i ZoneOffset. Regionalna zona određuje pravila za promjene pomaka; fiksni pomak nema takvih promjena.
ZonedDateTime.of stvara vrijednost iz lokalnog datuma i vremena te zone. U praznini pomiče vrijeme unaprijed za trajanje praznine; pri preklapanju odabire raniji pomak. ZonedDateTime.ofLocal prima i preferirani pomak: koristi ga ako je valjan, a inače odabire raniji pomak; null znači da nema preferencije. Praznine razrješava na isti način. ZonedDateTime.ofInstant(instant, zone) čuva zadani trenutak bez te nejasnoće.
ZonedDateTime.withZoneSameInstant čuva trenutak i obično mijenja lokalno vrijeme. ZonedDateTime.withZoneSameLocal čuva lokalni datum i vrijeme ako je moguće te primjenjuje pravila metode ofLocal; trenutak se može promijeniti. ZonedDateTime.toInstant vraća samo trenutak, bez identifikatora zone, dok ZonedDateTime.format oblikuje vrijednost pomoću DateTimeFormatter.
ZonedDateTime.with(adjuster) primjenjuje TemporalAdjuster, a ZonedDateTime.with(field, value) postavlja polje. ZonedDateTime.withHour postavlja sat na 0–23, a ZonedDateTime.withMinute minutu na 0–59. Sačuvajte vraćenu vrijednost: izvorna se ne mijenja. Lokalne promjene sata ili minute također slijede pravila za praznine i preklapanja; ne znače dodavanje proteklog trajanja.
Primjeri
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()));
}
}Rezultat
2024-01-15T06:00:00-05:00 2024-01-15T12:00:00-05:00 true false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.