Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

ZonedDateTime — datum a čas s časovým pásmem

ZonedDateTime spojuje místní datum a čas, časové pásmo a vyřešený posun od UTC. Rozlišuje změnu pásma při zachování okamžiku od zachování místního času a řeší nejednoznačnosti způsobené změnami času.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

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 neměnná a vláknově bezpečná hodnota data a času ISO s ZoneId a ZoneOffset. Regionální pásmo určuje pravidla pro změny posunu; pevný posun takové změny nemá.

ZonedDateTime.of vytvoří hodnotu z místního data a času a pásma. Při mezeře posune čas dopředu o délku mezery; při překryvu zvolí dřívější posun. ZonedDateTime.ofLocal navíc přijímá preferovaný posun: použije ho, pokud je platný, jinak zvolí dřívější posun; null znamená, že není zadána žádná preference. Mezery řeší stejně. ZonedDateTime.ofInstant(instant, zone) zachová zadaný okamžik bez této nejednoznačnosti.

ZonedDateTime.withZoneSameInstant zachová okamžik a obvykle změní místní čas. ZonedDateTime.withZoneSameLocal pokud možno zachová místní datum a čas a použije pravidla ofLocal; okamžik se může změnit. ZonedDateTime.toInstant vrátí pouze okamžik, bez identifikátoru pásma, zatímco ZonedDateTime.format naformátuje hodnotu pomocí DateTimeFormatter.

ZonedDateTime.with(adjuster) použije TemporalAdjuster, zatímco ZonedDateTime.with(field, value) nastaví pole. ZonedDateTime.withHour nastaví hodinu na 0–23 a ZonedDateTime.withMinute minutu na 0–59. Uchovejte vrácenou hodnotu: původní se nezmění. I místní změny hodiny nebo minuty se řídí pravidly pro mezery a překryvy; neznamenají přičtení uplynulé doby.

Pří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ýsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje