CKTIS / Java
ZonedDateTime: ta sama chwila czy ta sama godzina na zegarze?
Dowiedz się, jak utworzyć datę i godzinę ze strefą w Javie 21, jawnie wybrać każde z dwóch wystąpień powtórzonej godziny i zmienić strefę z zachowaniem chwili albo czasu lokalnego.
Wersja: Java SE 21
Składnia
java.time.ZonedDateTime — Java SE 21
public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)
public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)
public ZonedDateTime withZoneSameInstant(ZoneId zone)
public ZonedDateTime withZoneSameLocal(ZoneId zone)java.time.ZonedDateTime łączy lokalną datę i godzinę z identyfikatorem strefy (ZoneId) oraz przesunięciem względem UTC (ZoneOffset). Chwila (Instant) to punkt na osi czasu. Lokalna data i godzina to wskazanie kalendarza i zegara, które w danej strefie może oznaczać dwie różne chwile.
ZonedDateTime.of to metoda statyczna z trzema przeciążeniami: przyjmuje LocalDateTime, osobno LocalDate i LocalTime albo siedem pól liczbowych; każde przeciążenie przyjmuje też ZoneId. Gdy jest jedno poprawne przesunięcie, używa go. W okresie powtórzenia czasu (overlap) używa przesunięcia odpowiadającego pierwszemu wystąpieniu. W luce (gap) przesuwa czas lokalny do przodu o długość luki i stosuje przesunięcie po zmianie. Niepoprawne pola daty lub godziny w przeciążeniu liczbowym powodują DateTimeException.
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) to statyczna metoda tworząca wartość. Przy powtórzeniu używa preferowanego przesunięcia tylko wtedy, gdy jest jednym z dwóch poprawnych. Dla null lub niepasującej wartości wybiera pierwsze wystąpienie. Przy jednym poprawnym przesunięciu lub w luce zachowuje się jak of. Preferencja nie służy do walidacji: jeśli aplikacja ma odrzucać luki lub wymagać jawnego wyboru przy powtórzeniu, sprawdź zone.getRules().getValidOffsets(localDateTime), które zwraca 0, 1 lub 2 przesunięcia.
ZonedDateTime.withZoneSameInstant(zone) pokazuje to samo zdarzenie w innej strefie: toInstant() pozostaje równe, choć lokalna data lub godzina może się zmienić. Nie trzeba rozstrzygać powtórzenia ani luki na lokalnej osi czasu; wynik poza obsługiwanym zakresem dat powoduje DateTimeException. ZonedDateTime.withZoneSameLocal(zone) traktuje tę samą datę i godzinę jako czas w strefie docelowej, więc chwila może się zmienić. Stosuje zasady ofLocal, preferując dotychczasowe przesunięcie. W luce czas lokalny nie zostanie zachowany. Żadna z metod nie modyfikuje obiektu wejściowego.
Przykłady
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
public class ZonedDateTimeTransform {
public static void main(String[] args) {
ZoneId paris = ZoneId.of("Europe/Paris");
LocalDateTime wallTime = LocalDateTime.of(2024, 10, 27, 2, 30);
ZonedDateTime defaultChoice = ZonedDateTime.of(wallTime, paris);
ZonedDateTime earlier = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(2));
ZonedDateTime later = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(1));
System.out.println("of: " + defaultChoice);
System.out.println("ofLocal +02:00: " + earlier + " -> " + earlier.toInstant());
System.out.println("ofLocal +01:00: " + later + " -> " + later.toInstant());
System.out.println("same instant: " + earlier.withZoneSameInstant(ZoneOffset.UTC));
System.out.println("same local: " + earlier.withZoneSameLocal(ZoneOffset.UTC));
}
}Wynik
of: 2024-10-27T02:30+02:00[Europe/Paris] ofLocal +02:00: 2024-10-27T02:30+02:00[Europe/Paris] -> 2024-10-27T00:30:00Z ofLocal +01:00: 2024-10-27T02:30+01:00[Europe/Paris] -> 2024-10-27T01:30:00Z same instant: 2024-10-27T00:30Z same local: 2024-10-27T02:30Z
Dla reguł `Europe/Paris` użytych w przykładzie `02:30` występuje dwa razy: z `+02:00` oznacza `00:30Z`, a z `+01:00` — `01:30Z`. `of` wybiera pierwszy przypadek, a dwa wywołania `ofLocal` wybierają oba przesunięcia jawnie. Przejście na UTC z pierwszego wystąpienia daje `00:30Z` przy zachowaniu chwili albo `02:30Z` przy zachowaniu wskazania zegara. Wynik dla strefy regionalnej zależy od reguł dostępnych w środowisku uruchomieniowym.
Powiązane lekcje
- Java · Lekcja 60 · Zaawansowany · Wersja: 2