Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri