CKTIS / Java
ZonedDateTime — datum in čas s časovnim pasom
ZonedDateTime združuje lokalni datum in čas, časovni pas ter razrešeni odmik UTC. Razlikuje med spremembo pasu ob ohranitvi trenutka in ohranitvijo lokalnega časa ter obravnava dvoumnosti zaradi premikov ure.
Različica: 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 nespremenljiva in nitno varna vrednost datuma in časa ISO z ZoneId in ZoneOffset. Regionalni pas določa pravila za spremembe odmika; fiksni odmik takih sprememb nima.
ZonedDateTime.of ustvari vrednost iz lokalnega datuma in časa ter pasu. Ob vrzeli premakne čas naprej za dolžino vrzeli; ob prekrivanju izbere zgodnejši odmik. ZonedDateTime.ofLocal sprejme tudi prednostni odmik: uporabi ga, če je veljaven, sicer izbere zgodnejši odmik; null pomeni, da ni prednosti. Vrzeli razreši enako. ZonedDateTime.ofInstant(instant, zone) ohrani navedeni trenutek brez te dvoumnosti.
ZonedDateTime.withZoneSameInstant ohrani trenutek in običajno spremeni lokalni čas. ZonedDateTime.withZoneSameLocal po možnosti ohrani lokalni datum in čas ter uporabi pravila ofLocal; trenutek se lahko spremeni. ZonedDateTime.toInstant vrne samo trenutek, brez identifikatorja pasu, medtem ko ZonedDateTime.format oblikuje vrednost z uporabo DateTimeFormatter.
ZonedDateTime.with(adjuster) uporabi TemporalAdjuster, ZonedDateTime.with(field, value) pa nastavi polje. ZonedDateTime.withHour nastavi uro na 0–23, ZonedDateTime.withMinute pa minuto na 0–59. Ohranite vrnjeno vrednost: izvirnik ostane nespremenjen. Tudi lokalne spremembe ure ali minute upoštevajo pravila za vrzeli in prekrivanja; ne pomenijo prištevanja pretečenega časa.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.