CKTIS / Java
ZoneId.of: wybór strefy czasowej na podstawie identyfikatora
Użyj `ZoneId.of`, aby wybrać strefę regionalną lub stałe przesunięcie względem UTC i przedstawić ten sam moment w Warszawie, Nowym Jorku i Tokio.
Wersja: Java SE 21
Składnia
import java.time.ZoneId;
import java.util.Map;
// Static method signatures in java.time.ZoneId:
public static ZoneId of(String zoneId)
public static ZoneId of(String zoneId, Map<String, String> aliasMap)
// Example calls:
ZoneId.of("Europe/Warsaw")
ZoneId.of("+02:00")
ZoneId.of("office", Map.of("office", "Europe/Warsaw"))ZoneId.of(String) to statyczna metoda fabrykująca klasy java.time.ZoneId. Przyjmuje identyfikator inny niż null i zwraca strefę, której reguły są dostępne w środowisku uruchomieniowym. Sama nie tworzy daty ani godziny.
Europe/Warsaw, America/New_York i Asia/Tokyo to identyfikatory regionalne z domyślnej bazy IANA TZDB. Zachowaj wielkość liter. Przesunięcie strefy regionalnej zależy od jej reguł i danego momentu, więc może się zmieniać, np. przy przejściu na czas letni. +02:00 i Z zwracają obiekt ZoneOffset o stałym przesunięciu. UTC, GMT i UT zachowują swój identyfikator przy zerowym przesunięciu; UTC+02:00 zachowuje prefiks UTC i ma stałe przesunięcie.
ZoneId.of(String, Map<String, String>) najpierw zastępuje identyfikator odpowiadającą mu wartością z mapy, jeśli taka istnieje, a następnie rozpoznaje wynik tak jak wariant z jednym argumentem. Mapa nie może być null. Do obsługi starszych skrótów możesz jawnie przekazać ZoneId.SHORT_IDS; nie zakładaj, że skróty są jednoznaczne ani że wariant z jednym argumentem korzysta z tej mapy.
Niepoprawny format powoduje DateTimeException, a poprawnie zapisany, lecz niedostępny identyfikator regionalny powoduje ZoneRulesException, podklasę DateTimeException. Obsłuż te błędy jawnie zamiast po cichu zastępować strefę domyślną. W przykładzie Instant.atZone tworzy ZonedDateTime: zmienia się lokalna reprezentacja, ale nie moment na osi czasu. Dostępne identyfikatory regionalne i ich reguły zależą od danych stref czasowych środowiska uruchomieniowego.
Przykłady
import java.time.Instant;
import java.time.ZoneId;
public class ZoneIdExample {
public static void main(String[] args) {
Instant instant = Instant.parse("2024-07-01T12:00:00Z");
String[] zoneIds = {"Europe/Warsaw", "America/New_York", "Asia/Tokyo"};
for (String id : zoneIds) {
ZoneId zone = ZoneId.of(id);
System.out.println(instant.atZone(zone));
}
}
}Wynik
2024-07-01T14:00+02:00[Europe/Warsaw] 2024-07-01T08:00-04:00[America/New_York] 2024-07-01T21:00+09:00[Asia/Tokyo]
Każdy wiersz przedstawia ten sam ustalony moment: podaje lokalną datę i godzinę, przesunięcie względem UTC oraz identyfikator regionu w nawiasach kwadratowych.
Powiązane lekcje
- Java · Lekcja 59 · Średniozaawansowany · Wersja: 2