CKTIS / Java
ZoneId.of et ZoneId.getRules : règles des fuseaux horaires
Déterminez les décalages par rapport à UTC à Varsovie et à New York au même instant en 2025, et voyez pourquoi un décalage fixe ne remplace pas un fuseau régional.
Version : Java SE 21
Syntaxe
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()Dans java.time, la méthode de fabrique statique ZoneId.of(String) valide un identifiant et renvoie un ZoneId. Europe/Warsaw et America/New_York désignent des fuseaux régionaux ; +01:00 donne un ZoneOffset, un décalage fixe par rapport à UTC. Deux fuseaux peuvent avoir le même décalage à un instant donné sans suivre les mêmes règles.
La surcharge ZoneId.of(String, Map<String, String>) permet de fournir votre propre table de correspondance entre alias et identifiants. Préférez les identifiants régionaux aux abréviations ambiguës. Un format invalide déclenche une DateTimeException ; un identifiant régional bien formé mais inconnu déclenche une ZoneRulesException, sous-type de DateTimeException.
La méthode d’instance ZoneId.getRules() renvoie un objet immuable de type java.time.zone.ZoneRules. getOffset(Instant) donne l’unique décalage applicable à cet instant. Pour un LocalDateTime, utilisez getValidOffsets : aucun décalage dans l’intervalle sauté quand l’horloge avance, un hors transition et généralement deux dans l’intervalle répété quand elle recule. En théorie, plus de deux décalages valides sont possibles si l’horloge est reculée deux fois à peu d’intervalle. Dans un intervalle sauté ou répété, getOffset(LocalDateTime) renvoie le décalage d’avant la transition ; dans l’intervalle sauté, il n’est pas valide pour l’heure locale donnée.
Les règles régionales proviennent d’un ZoneRulesProvider, dont la source de données par défaut est la TZDB de l’IANA. Les résultats historiques dépendent des données de l’environnement d’exécution. Un fournisseur qui accepte les mises à jour dynamiques peut renvoyer d’autres règles lors d’un appel ultérieur à getRules(). Si les règles d’un identifiant désérialisé ne sont pas disponibles, getRules() lève une ZoneRulesException.
Exemples
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));
}
}
}Résultat
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
Chaque ligne compare le même instant UTC. Le 15 mars 2025, New York est déjà à l’heure d’été, mais pas Varsovie. Au 1er avril, Varsovie a aussi changé de décalage ; le décalage fixe `+01:00` reste inchangé.
Leçons associées
- Java · Leçon 60 · Avancé · Version : 2