CKTIS / Java
ZoneId.of en ZoneId.getRules: regels voor tijdzones
Zoek de UTC-afwijkingen op hetzelfde tijdstip in 2025 op voor Warschau en New York en ontdek waarom een vaste afwijking geen regionale tijdzone kan vervangen.
Versie: Java SE 21
Syntax
java.time.ZoneId
public static ZoneId of(String zoneId)
public static ZoneId of(String zoneId, java.util.Map<String, String> aliasMap)
public abstract java.time.zone.ZoneRules getRules()De statische fabrieksmethode ZoneId.of(String) uit java.time valideert een ID en geeft een ZoneId terug. Europe/Warsaw en America/New_York duiden regionale tijdzones aan; +01:00 levert een ZoneOffset op, een vaste afwijking ten opzichte van UTC. Dezelfde afwijking op één tijdstip betekent niet dat de regels gelijk zijn.
Met de overload ZoneId.of(String, Map<String, String>) koppel je zelf aliassen aan zone-ID’s. Kies regio-ID’s in plaats van dubbelzinnige afkortingen. Een ongeldige notatie leidt tot een DateTimeException; een correct gevormde maar onbekende regio-ID leidt tot een ZoneRulesException, een subtype van DateTimeException.
De instantiemethode ZoneId.getRules() geeft een onveranderlijk java.time.zone.ZoneRules-object terug. getOffset(Instant) geeft de ene afwijking die op dat tijdstip geldt. Gebruik voor een LocalDateTime de methode getValidOffsets: nul afwijkingen in het overgeslagen interval als de klok vooruitgaat, één buiten een overgang en meestal twee in het herhaalde interval als de klok teruggaat. In theorie zijn meer dan twee geldige afwijkingen mogelijk als de klok kort na elkaar twee keer wordt teruggezet. In een overgeslagen of herhaald interval geeft getOffset(LocalDateTime) de afwijking van vóór de overgang; in het overgeslagen interval is die niet geldig voor de opgegeven lokale tijd.
Regionale regels komen van een ZoneRulesProvider; de standaardgegevensbron is de IANA TZDB. Historische resultaten hangen af van de gegevens van de runtime. Een provider die dynamische updates ondersteunt, kan bij een latere aanroep van getRules() andere regels teruggeven. Zijn de regels voor een gedeserialiseerde ID niet beschikbaar, dan gooit getRules() een ZoneRulesException.
Voorbeelden
import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;
public class Main {
public static void main(String[] args) {
ZoneRules warsaw = ZoneId.of("Europe/Warsaw").getRules();
ZoneRules newYork = ZoneId.of("America/New_York").getRules();
ZoneRules fixed = ZoneId.of("+01:00").getRules();
System.out.println("UTC instant | Europe/Warsaw | America/New_York | fixed +01:00");
for (String timestamp : new String[] {
"2025-03-01T12:00:00Z", "2025-03-15T12:00:00Z", "2025-04-01T12:00:00Z"
}) {
Instant instant = Instant.parse(timestamp);
System.out.println(instant + " | " + warsaw.getOffset(instant)
+ " | " + newYork.getOffset(instant) + " | " + fixed.getOffset(instant));
}
}
}Resultaat
UTC instant | Europe/Warsaw | America/New_York | fixed +01:00 2025-03-01T12:00:00Z | +01:00 | -05:00 | +01:00 2025-03-15T12:00:00Z | +01:00 | -04:00 | +01:00 2025-04-01T12:00:00Z | +02:00 | -04:00 | +01:00
Elke rij vergelijkt hetzelfde UTC-tijdstip. Op 15 maart 2025 geldt in New York al zomertijd, maar in Warschau nog niet. Op 1 april is de afwijking in Warschau ook veranderd; de vaste `+01:00` blijft gelijk.
Gerelateerde lessen
- Java · Les 60 · Gevorderd · Versie: 2