CKTIS / Java
ZoneId.of: een tijdzone kiezen op basis van de ID
Gebruik `ZoneId.of` om een regionale tijdzone of een vaste UTC-offset te kiezen en hetzelfde tijdstip in Warschau, New York en Tokio weer te geven.
Versie: 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) is een statische fabrieksmethode van de klasse java.time.ZoneId. De methode neemt een ID die niet null is en geeft een tijdzone terug waarvan de regels beschikbaar zijn in de runtime. De methode maakt zelf geen datum of tijd aan.
Europe/Warsaw, America/New_York en Asia/Tokyo zijn regio-ID's uit de standaard gebruikte IANA TZDB. Neem de hoofdletters en kleine letters precies over. De offset van een regio hangt af van de regels en het tijdstip en kan dus veranderen, bijvoorbeeld bij de overgang naar zomertijd. +02:00 en Z geven een vaste ZoneOffset terug. UTC, GMT en UT behouden hun ID met een offset van nul; UTC+02:00 behoudt het voorvoegsel UTC en heeft een vaste offset.
ZoneId.of(String, Map<String, String>) vervangt de ID eerst door de bijbehorende waarde als de map een overeenkomende sleutel bevat. Daarna verwerkt de methode de resulterende ID op dezelfde manier als de overload met één argument. De map mag niet null zijn. Voor oudere afkortingen kun je ZoneId.SHORT_IDS expliciet meegeven. Ga er niet van uit dat afkortingen ondubbelzinnig zijn of dat de overload met één argument deze map gebruikt.
Ongeldige syntaxis leidt tot DateTimeException; een correct geschreven maar niet beschikbare regio-ID leidt tot ZoneRulesException, een subklasse van DateTimeException. Handel deze fouten expliciet af in plaats van stilzwijgend op de standaardtijdzone terug te vallen. In het voorbeeld maakt Instant.atZone een ZonedDateTime: de lokale weergave verandert, maar het tijdstip blijft hetzelfde. De beschikbare regio-ID's en regels hangen af van de tijdzonegegevens van de runtime.
Voorbeelden
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));
}
}
}Resultaat
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]
Elke regel toont hetzelfde vaste tijdstip als lokale datum en tijd, gevolgd door de UTC-offset en de regio-ID tussen vierkante haken.
Gerelateerde lessen
- Java · Les 59 · Gemiddeld · Versie: 2