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.