Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources