CKTIS / Java
ZoneId.of e ZoneId.getRules: regole dei fusi orari
Calcola gli scarti rispetto a UTC a Varsavia e New York nello stesso istante del 2025 e scopri perché uno scarto fisso non sostituisce un fuso orario regionale.
Versione: Java SE 21
Sintassi
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()Il metodo factory statico ZoneId.of(String) di java.time convalida un identificatore e restituisce un ZoneId. Europe/Warsaw e America/New_York identificano fusi orari regionali; +01:00 produce un ZoneOffset, uno scarto fisso rispetto a UTC. Lo stesso scarto in un dato istante non implica che le regole siano uguali.
Il sovraccarico ZoneId.of(String, Map<String, String>) consente di fornire una mappa personalizzata dagli alias agli identificatori. Preferisci gli identificatori regionali alle abbreviazioni ambigue. Un formato non valido causa una DateTimeException; un identificatore regionale ben formato ma sconosciuto causa una ZoneRulesException, sottotipo di DateTimeException.
Il metodo di istanza ZoneId.getRules() restituisce un oggetto immutabile java.time.zone.ZoneRules. getOffset(Instant) restituisce l’unico scarto in vigore in quell’istante. Per un LocalDateTime, usa getValidOffsets: ottieni zero scarti nell’intervallo saltato quando l’orologio avanza, uno fuori da una transizione e di norma due nell’intervallo ripetuto quando torna indietro. In teoria, possono esserci più di due scarti validi se si rimettono indietro le lancette due volte a breve distanza. In un intervallo saltato o ripetuto, getOffset(LocalDateTime) restituisce lo scarto precedente alla transizione, che nell’intervallo saltato non è valido per l’ora locale indicata.
Le regole regionali provengono da un ZoneRulesProvider; la fonte predefinita dei dati è la TZDB di IANA. I risultati storici dipendono dai dati dell’ambiente di esecuzione. Un fornitore che supporta aggiornamenti dinamici può restituire regole diverse a una chiamata successiva a getRules(). Se le regole di un identificatore deserializzato non sono disponibili, getRules() lancia una ZoneRulesException.
Esempi
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));
}
}
}Risultato
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
Ogni riga confronta lo stesso istante UTC. Il 15 marzo 2025 è già in vigore l’ora legale a New York, ma non ancora a Varsavia. Al 1º aprile anche Varsavia ha cambiato scarto; quello fisso `+01:00` resta invariato.
Lezioni correlate
- Java · Lezione 60 · Avanzato · Versione: 2