CKTIS / Java
ZoneId.of in ZoneId.getRules: pravila časovnih pasov
Poišči odmika od UTC v Varšavi in New Yorku za isti trenutek leta 2025 ter preveri, zakaj stalni odmik ne more nadomestiti regionalnega časovnega pasu.
Različica: Java SE 21
Sintaksa
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()Statična tovarniška metoda ZoneId.of(String) iz paketa java.time preveri identifikator in vrne ZoneId. Europe/Warsaw in America/New_York označujeta regionalna časovna pasova; +01:00 vrne ZoneOffset, torej stalni odmik od UTC. Enak odmik v nekem trenutku še ne pomeni enakih pravil.
Preobremenitev ZoneId.of(String, Map<String, String>) omogoča, da podaš lastno preslikavo vzdevkov v identifikatorje časovnih pasov. Namesto dvoumnih kratic uporabljaj regionalne identifikatorje. Neveljavna oblika sproži DateTimeException, pravilno zapisan, a neznan regionalni identifikator pa ZoneRulesException, podtip DateTimeException.
Instančna metoda ZoneId.getRules() vrne nespremenljiv objekt java.time.zone.ZoneRules. getOffset(Instant) vrne edini odmik, ki velja v danem trenutku. Za LocalDateTime uporabi getValidOffsets: vrne nič odmikov v preskočenem intervalu ob premiku ure naprej, enega zunaj prehoda in običajno dva v ponovljenem intervalu ob premiku ure nazaj. Če uro dvakrat zapored v kratkem času premaknemo nazaj, sta teoretično možna tudi več kot dva veljavna odmika. V preskočenem ali ponovljenem intervalu vrne getOffset(LocalDateTime) odmik pred prehodom, ki v preskočenem intervalu ni veljaven za navedeni lokalni čas.
Regionalna pravila zagotavlja ZoneRulesProvider; privzeti vir podatkov je IANA TZDB. Zgodovinski rezultati so odvisni od podatkov izvajalnega okolja. Ponudnik, ki podpira dinamične posodobitve, lahko pri poznejšem klicu getRules() vrne drugačna pravila. Če po deserializaciji identifikatorja njegova pravila niso na voljo, getRules() sproži ZoneRulesException.
Primeri
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));
}
}
}Rezultat
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
Vsaka vrstica primerja isti trenutek v UTC. Petnajstega marca 2025 v New Yorku že velja poletni čas, v Varšavi pa še ne. Do 1. aprila se odmik spremeni tudi v Varšavi; stalni `+01:00` ostane nespremenjen.
Povezane lekcije
- Java · Lekcija 60 · Napredna · Različica: 2