CKTIS / Java
ZoneId.of i ZoneId.getRules: pravila vremenskih zona
Pronađi pomake u odnosu na UTC u Varšavi i New Yorku u istom trenutku 2025. godine i provjeri zašto fiksni pomak ne može zamijeniti regionalnu vremensku zonu.
Verzija: 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čka tvornička metoda ZoneId.of(String) iz paketa java.time provjerava identifikator i vraća ZoneId. Europe/Warsaw i America/New_York označavaju regionalne vremenske zone; +01:00 daje ZoneOffset, odnosno fiksni pomak u odnosu na UTC. Jednak pomak u jednom trenutku ne znači da su pravila jednaka.
Preopterećena metoda ZoneId.of(String, Map<String, String>) omogućuje da zadaš vlastito preslikavanje zamjenskih naziva u identifikatore zona. Umjesto dvosmislenih kratica upotrebljavaj regionalne identifikatore. Neispravan format uzrokuje DateTimeException, a ispravno oblikovan, ali nepoznat regionalni identifikator uzrokuje ZoneRulesException, podtip DateTimeException.
Instancijska metoda ZoneId.getRules() vraća nepromjenjiv objekt java.time.zone.ZoneRules. getOffset(Instant) vraća jedini pomak koji vrijedi u danom trenutku. Za LocalDateTime upotrijebi getValidOffsets: ne vraća nijedan pomak u preskočenom intervalu pri pomicanju sata unaprijed, vraća jedan izvan prijelaza, a obično dva u ponovljenom intervalu pri pomicanju sata unatrag. Teoretski može biti više od dva valjana pomaka ako se sat dvaput pomakne unatrag u kratkom razmaku. U preskočenom ili ponovljenom intervalu getOffset(LocalDateTime) vraća pomak prije prijelaza, koji u preskočenom intervalu nije valjan za zadano lokalno vrijeme.
Regionalna pravila pruža ZoneRulesProvider; zadani je izvor podataka IANA TZDB. Povijesni rezultati ovise o podacima izvršnog okruženja. Pružatelj koji podržava dinamička ažuriranja može pri kasnijem pozivu getRules() vratiti druga pravila. Ako pravila za deserijalizirani identifikator nisu dostupna, getRules() baca ZoneRulesException.
Primjeri
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
Svaki redak uspoređuje isti trenutak u UTC-u. Dana 15. ožujka 2025. u New Yorku već vrijedi ljetno računanje vremena, a u Varšavi još ne. Do 1. travnja pomak se promijenio i u Varšavi; fiksni `+01:00` ostaje isti.
Povezane lekcije
- Java · Lekcija 60 · Napredno · Verzija: 2