CKTIS / Java
ZoneId.of a ZoneId.getRules: pravidlá časových pásiem
Zisti posuny voči UTC vo Varšave a New Yorku v tom istom okamihu v roku 2025 a over si, prečo pevný posun nenahradí regionálne časové pásmo.
Verzia: 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()Statická továrenská metóda ZoneId.of(String) z balíka java.time overí identifikátor a vráti ZoneId. Europe/Warsaw a America/New_York označujú regionálne pásma; +01:00 dá ZoneOffset, teda pevný posun voči UTC. Rovnaký posun v jednom okamihu neznamená rovnaké pravidlá.
Preťažený variant ZoneId.of(String, Map<String, String>) umožňuje dodať vlastnú mapu aliasov na identifikátory pásiem. Používaj regionálne identifikátory namiesto nejednoznačných skratiek. Neplatný formát vyvolá DateTimeException; správne zapísaný, ale neznámy regionálny identifikátor vyvolá ZoneRulesException, podtyp DateTimeException.
Inštančná metóda ZoneId.getRules() vráti nemenný objekt java.time.zone.ZoneRules. getOffset(Instant) vráti jediný posun platný v danom okamihu. Pre LocalDateTime použi getValidOffsets: vráti nula posunov v preskočenom intervale pri posune hodín dopredu, jeden mimo prechodu a zvyčajne dva v opakovanom intervale pri posune hodín späť. Ak sa hodiny posunú späť dvakrát krátko po sebe, teoreticky môžu byť platné aj viac než dva posuny. V preskočenom alebo opakovanom intervale vráti getOffset(LocalDateTime) posun pred prechodom; v preskočenom intervale nie je pre zadaný miestny čas platný.
Regionálne pravidlá dodáva ZoneRulesProvider; predvoleným zdrojom údajov je IANA TZDB. Historické výsledky závisia od údajov behového prostredia. Poskytovateľ s podporou dynamických aktualizácií môže pri neskoršom volaní getRules() vrátiť iné pravidlá. Ak pravidlá pre deserializovaný identifikátor nie sú dostupné, getRules() vyvolá ZoneRulesException.
Príklady
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));
}
}
}Výsledok
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
Každý riadok porovnáva ten istý okamih v UTC. Dňa 15. marca 2025 už v New Yorku platí letný čas, vo Varšave ešte nie. K 1. aprílu sa posun zmenil aj vo Varšave; pevný posun `+01:00` sa nemení.
Súvisiace lekcie
- Java · Lekcia 60 · Pokročilá · Verzia: 2