Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

ZonedDateTime — dátum a čas s časovým pásmom

ZonedDateTime spája miestny dátum a čas, časové pásmo a vyriešený posun od UTC. Rozlišuje zmenu pásma pri zachovaní okamihu od zachovania miestneho času a rieši nejednoznačnosti spôsobené zmenami času.

Verzia: 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 je nemenná a vláknovo bezpečná hodnota dátumu a času ISO s ZoneId a ZoneOffset. Regionálne pásmo určuje pravidlá pre zmeny posunu; pevný posun takéto zmeny nemá.

ZonedDateTime.of vytvorí hodnotu z miestneho dátumu a času a pásma. Pri medzere posunie čas dopredu o dĺžku medzery; pri prekrytí vyberie skorší posun. ZonedDateTime.ofLocal navyše prijíma preferovaný posun: použije ho, ak je platný, inak vyberie skorší posun; null znamená, že nie je zadaná žiadna preferencia. Medzery rieši rovnako. ZonedDateTime.ofInstant(instant, zone) zachová zadaný okamih bez tejto nejednoznačnosti.

ZonedDateTime.withZoneSameInstant zachová okamih a zvyčajne zmení miestny čas. ZonedDateTime.withZoneSameLocal podľa možností zachová miestny dátum a čas a uplatní pravidlá ofLocal; okamih sa môže zmeniť. ZonedDateTime.toInstant vráti iba okamih, bez identifikátora pásma, zatiaľ čo ZonedDateTime.format naformátuje hodnotu pomocou DateTimeFormatter.

ZonedDateTime.with(adjuster) použije TemporalAdjuster, zatiaľ čo ZonedDateTime.with(field, value) nastaví pole. ZonedDateTime.withHour nastaví hodinu na 0–23 a ZonedDateTime.withMinute minútu na 0–59. Zachovajte vrátenú hodnotu: pôvodná sa nezmení. Aj miestne zmeny hodiny alebo minúty sa riadia pravidlami pre medzery a prekrytia; neznamenajú pripočítanie uplynutého času.

Príklady

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()));
    }
}

Výsledok

2024-01-15T06:00:00-05:00
2024-01-15T12:00:00-05:00
true
false

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje