Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ZonedDateTime — data i czas ze strefą czasową

ZonedDateTime łączy lokalną datę i czas, strefę oraz rozwiązane przesunięcie względem UTC. Rozróżnia zmianę strefy z zachowaniem chwili od zachowania lokalnej godziny i obsługuje niejednoznaczności zmian czasu.

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

Składnia

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 to niemutowalna, bezpieczna wątkowo data i czas ISO ze strefą ZoneId oraz przesunięciem ZoneOffset. Strefa regionalna określa reguły zmian przesunięcia; stałe przesunięcie nie ma takich zmian.

ZonedDateTime.of tworzy wartość z lokalnej daty i czasu oraz strefy. Przy luce przesuwa czas o długość luki; przy nakładaniu wybiera wcześniejsze przesunięcie. ZonedDateTime.ofLocal przyjmuje dodatkowo preferowane przesunięcie: używa go, jeśli jest poprawne, inaczej wcześniejszego; null oznacza brak preferencji. Lukę rozwiązuje tak samo. ZonedDateTime.ofInstant(instant, zone) zachowuje wskazaną chwilę bez tej niejednoznaczności.

ZonedDateTime.withZoneSameInstant zachowuje chwilę, zwykle zmieniając lokalną godzinę. ZonedDateTime.withZoneSameLocal zachowuje lokalną datę i czas, jeśli to możliwe, stosując reguły ofLocal; może zmienić chwilę. ZonedDateTime.toInstant zwraca samą chwilę, bez identyfikatora strefy, a ZonedDateTime.format formatuje wartość za pomocą DateTimeFormatter.

ZonedDateTime.with(adjuster) stosuje TemporalAdjuster, a ZonedDateTime.with(field, value) ustawia pole. ZonedDateTime.withHour ustawia godzinę 0–23, a ZonedDateTime.withMinute minutę 0–59. Zachowuj zwracany wynik: oryginał się nie zmienia. Lokalne zmiany godziny lub minuty również podlegają regułom luk i nakładania; nie oznaczają dodania czasu trwania.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła