CKTIS / Java
ZoneId.of: eine Zeitzone anhand ihrer ID auswählen
Mit `ZoneId.of` wählst du eine regionale Zeitzone oder einen festen UTC-Offset und stellst denselben Zeitpunkt in Warschau, New York und Tokio dar.
Version: Java SE 21
Syntax
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) ist eine statische Fabrikmethode der Klasse java.time.ZoneId. Sie akzeptiert eine ID, die nicht null ist, und liefert eine Zone, deren Regeln in der Laufzeitumgebung verfügbar sind. Die Methode selbst erzeugt weder ein Datum noch eine Uhrzeit.
Europe/Warsaw, America/New_York und Asia/Tokyo sind regionale IDs aus der standardmäßig verwendeten IANA TZDB. Beachte die Groß- und Kleinschreibung. Der Offset einer Region hängt von ihren Regeln und vom Zeitpunkt ab und kann sich etwa bei der Umstellung auf Sommerzeit ändern. +02:00 und Z liefern einen festen ZoneOffset. UTC, GMT und UT behalten ihre IDs bei einem Offset von null; UTC+02:00 behält das Präfix UTC und hat einen festen Offset.
ZoneId.of(String, Map<String, String>) ersetzt die ID zunächst durch den zugeordneten Wert, falls die Map einen passenden Schlüssel enthält. Danach wird die resultierende ID wie bei der Überladung mit einem Argument aufgelöst. Die Map darf nicht null sein. Für ältere Kürzel kannst du ZoneId.SHORT_IDS ausdrücklich übergeben. Gehe nicht davon aus, dass Kürzel eindeutig sind oder dass die Überladung mit einem Argument diese Map verwendet.
Eine ungültige Syntax führt zu DateTimeException, eine formal gültige, aber nicht verfügbare regionale ID zu ZoneRulesException, einer Unterklasse von DateTimeException. Behandle diese Fehler ausdrücklich, statt stillschweigend auf die Standardzeitzone auszuweichen. Im Beispiel erzeugt Instant.atZone ein ZonedDateTime: Die lokale Darstellung ändert sich, der Zeitpunkt bleibt gleich. Die verfügbaren regionalen IDs und Regeln hängen von den Zeitzonendaten der Laufzeitumgebung ab.
Beispiele
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));
}
}
}Ergebnis
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]
Jede Zeile zeigt denselben festgelegten Zeitpunkt als lokales Datum mit Uhrzeit, gefolgt vom UTC-Offset und der regionalen ID in eckigen Klammern.
Zugehörige Lektionen
- Java · Lektion 59 · Mittlere Stufe · Version: 2