CKTIS / Java
ZoneId — un identificatore di fuso orario
ZoneId identifica un fuso orario, mentre ZoneRules ne descrive le regole di scostamento da UTC. Scopri ZoneId.of, ZoneId.getRules e la differenza tra una regione e uno scostamento fisso.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId identifica un fuso orario; non memorizza una data o un’ora. ZoneId.of(String) crea un identificatore di regione, ad esempio Europe/Paris, oppure uno scostamento fisso, ad esempio +02:00. Una regione non è la stessa cosa di uno scostamento fisso.
ZoneId.getRules() restituisce ZoneRules. Il suo metodo getOffset(Instant) fornisce lo scostamento per un istante specifico, mentre isFixedOffset() verifica se tale scostamento non cambia mai. Le regole regionali possono includere i cambi dell’ora e dipendono dai dati disponibili nell’ambiente di esecuzione.
A un Instant corrisponde un solo scostamento applicabile. Tuttavia, durante la conversione di un LocalDateTime, una transizione dello scostamento può creare un intervallo inesistente o una sovrapposizione tra gli orari locali. getValidOffsets(LocalDateTime) aiuta a individuare questi casi; non dare per scontato che un’ora locale identifichi sempre un solo istante.
Un formato non valido passato a ZoneId.of causa DateTimeException, mentre una regione sconosciuta causa ZoneRulesException. Anche ZoneId.getRules può generare ZoneRulesException se le regole non sono disponibili. L’esempio usa uno scostamento fisso e un istante specifico, così il risultato non dipende dall’orologio né dagli aggiornamenti dei dati regionali.
Esempi
import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;
public class Main {
public static void main(String[] args) {
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();
Instant instant = Instant.parse("2024-01-15T12:00:00Z");
System.out.println(zone.getId());
System.out.println(rules.isFixedOffset());
System.out.println(rules.getOffset(instant));
}
}Risultato
+02:00 true +02:00
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.