CKTIS / Java
ZonedDateTime: tworzenie, konwersje, formatowanie i zmiany kalendarzowe
Twórz daty i godziny w strefach czasowych, przeliczaj je bez zmiany chwili, formatuj wynik i zmieniaj lokalne pola z uwzględnieniem reguł strefy.
Wersja: Java SE 21
Składnia
java.time.ZonedDateTime — Java SE 21
static ZonedDateTime of(LocalDateTime dateTime, ZoneId zone)
static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
static ZonedDateTime ofInstant(Instant instant, ZoneId zone)
static ZonedDateTime ofInstant(LocalDateTime dateTime, ZoneOffset offset, ZoneId zone)
Instant toInstant() // inherited from ChronoZonedDateTime
ZonedDateTime withZoneSameInstant(ZoneId zone)
String format(DateTimeFormatter formatter)
ZonedDateTime with(TemporalAdjuster adjuster)
ZonedDateTime with(TemporalField field, long newValue)
ZonedDateTime withHour(int hour)
ZonedDateTime withMinute(int minute)java.time.ZonedDateTime przechowuje lokalną datę i godzinę, identyfikator strefy oraz ustalone przesunięcie względem UTC. Statyczna metoda ZonedDateTime.of przyjmuje LocalDateTime, parę LocalDate i LocalTime albo siedem liczb (year do nanoOfSecond), zawsze z ZoneId. W luce po przestawieniu zegara do przodu przesuwa lokalną datę i godzinę o długość luki. Gdy czas lokalny występuje dwukrotnie, wybiera przesunięcie odpowiadające wcześniejszej chwili. Nieprawidłowe pola liczbowe lub nieistniejąca data powodują DateTimeException.
ZonedDateTime.ofInstant(Instant, ZoneId) wyznacza lokalną datę, godzinę i przesunięcie dla podanej chwili w strefie docelowej. Przeciążenie (LocalDateTime, ZoneOffset, ZoneId) najpierw wyznacza chwilę z lokalnej daty i godziny oraz podanego przesunięcia, a następnie przedstawia ją w strefie docelowej; wynik może mieć inną godzinę lokalną i inne przesunięcie niż na wejściu. Odziedziczona metoda ZonedDateTime.toInstant() zwraca tę samą chwilę bez informacji o strefie. ZonedDateTime.withZoneSameInstant(ZoneId) zachowuje chwilę, ale może zmienić lokalną datę i godzinę. Natomiast withZoneSameLocal próbuje zachować lokalną datę i godzinę, co może zmienić chwilę.
ZonedDateTime.format(DateTimeFormatter) zwraca String bez zmiany obiektu. ISO_OFFSET_DATE_TIME wypisuje lokalną datę i godzinę oraz przesunięcie, ale nie identyfikator strefy regionalnej. Jeśli formatowanie się nie powiedzie, metoda zgłasza DateTimeException.
ZonedDateTime.with(TemporalAdjuster) stosuje regułę, np. TemporalAdjusters.lastDayOfMonth(). Przeciążenie with(TemporalField, long) ustawia obsługiwane pole, np. ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS ustawia sekundę na osi czasu, zachowując strefę i ułamek sekundy; OFFSET_SECONDS pozwala tylko przełączyć się na drugie prawidłowe przesunięcie przy powtórzeniu czasu. Nieobsługiwane pole może spowodować UnsupportedTemporalTypeException; nieprawidłowa wartość może spowodować DateTimeException.
ZonedDateTime.withHour(int) ustawia godzinę (0–23), a ZonedDateTime.withMinute(int) minutę (0–59); nie dodają czasu. Wartość spoza zakresu powoduje DateTimeException. Przy zmianach pól lokalnych strefa pozostaje ta sama, ale chwila może się zmienić. W luce wynik przesuwa się do przodu o długość luki, a przy powtórzeniu czasu zachowuje dotychczasowe przesunięcie, jeśli jest prawidłowe; w przeciwnym razie wybiera wcześniejszą chwilę. Obiekty są niemutowalne, więc zachowaj zwrócony wynik.
Przykłady
import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;
import java.time.temporal.TemporalAdjusters;
public class Main {
public static void main(String[] args) {
ZoneOffset east = ZoneOffset.of("+01:00");
ZoneOffset west = ZoneOffset.of("-05:00");
DateTimeFormatter iso = DateTimeFormatter.ISO_OFFSET_DATE_TIME;
ZonedDateTime original = ZonedDateTime.of(
LocalDateTime.of(2024, 1, 15, 10, 30), east);
Instant instant = original.toInstant();
ZonedDateTime converted = original.withZoneSameInstant(west);
ZonedDateTime rebuilt = ZonedDateTime.ofInstant(instant, west);
ZonedDateTime edited = original.with(ChronoField.MONTH_OF_YEAR, 2)
.with(TemporalAdjusters.lastDayOfMonth())
.withHour(14)
.withMinute(45);
System.out.println(original.format(iso));
System.out.println(instant);
System.out.println(converted.format(iso));
System.out.println(converted.equals(rebuilt));
System.out.println(edited.format(iso));
}
}Wynik
2024-01-15T10:30:00+01:00 2024-01-15T09:30:00Z 2024-01-15T04:30:00-05:00 true 2024-02-29T14:45:00+01:00
Pierwsze trzy wiersze przedstawiają tę samą chwilę. `true` potwierdza zgodność obu konwersji do `-05:00`. Ostatni wiersz pokazuje zmianę kalendarzową na 29 lutego o 14:45 przy pierwotnym przesunięciu. Stałe przesunięcia eliminują zależność przykładu od reguł stref regionalnych.
Powiązane lekcje
- Java · Lekcja 59 · Średniozaawansowany · Wersja: 2