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

CKTIS / Java

ZoneId.of : choisir un fuseau horaire par son identifiant

Utilisez `ZoneId.of` pour choisir un fuseau régional ou un décalage UTC fixe et afficher le même instant à Varsovie, à New York et à Tokyo.

Version : Java SE 21

Syntaxe

import java.time.ZoneId;
import java.util.Map;

// Static method signatures in java.time.ZoneId:
public static ZoneId of(String zoneId)
public static ZoneId of(String zoneId, Map<String, String> aliasMap)

// Example calls:
ZoneId.of("Europe/Warsaw")
ZoneId.of("+02:00")
ZoneId.of("office", Map.of("office", "Europe/Warsaw"))

ZoneId.of(String) est une méthode de fabrique statique de la classe java.time.ZoneId. Elle prend un identifiant non null et renvoie un fuseau dont les règles sont disponibles dans l’environnement d’exécution. Elle ne crée pas à elle seule de date ni d’heure.

Europe/Warsaw, America/New_York et Asia/Tokyo sont des identifiants régionaux de la base IANA TZDB utilisée par défaut. Respectez la casse. Le décalage d’un fuseau régional dépend de ses règles et de l’instant ; il peut donc changer, par exemple lors du passage à l’heure d’été. +02:00 et Z renvoient un ZoneOffset fixe. UTC, GMT et UT conservent leur identifiant avec un décalage nul ; UTC+02:00 conserve le préfixe UTC et a un décalage fixe.

ZoneId.of(String, Map<String, String>) remplace d’abord l’identifiant par la valeur associée si la map contient la clé correspondante, puis résout l’identifiant obtenu comme le fait la surcharge à un argument. La map ne doit pas être null. Vous pouvez passer explicitement ZoneId.SHORT_IDS pour les anciennes abréviations. Ne supposez ni que ces abréviations sont sans ambiguïté, ni que la surcharge à un argument utilise cette map.

Une syntaxe invalide provoque une DateTimeException ; un identifiant régional bien formé mais indisponible provoque une ZoneRulesException, sous-classe de DateTimeException. Traitez explicitement ces erreurs au lieu de revenir silencieusement au fuseau par défaut. Dans l’exemple, Instant.atZone crée un ZonedDateTime : la représentation locale change, mais pas l’instant. Les identifiants régionaux et les règles disponibles dépendent des données de fuseaux de l’environnement d’exécution.

Exemples

import java.time.Instant;
import java.time.ZoneId;

public class ZoneIdExample {
    public static void main(String[] args) {
        Instant instant = Instant.parse("2024-07-01T12:00:00Z");
        String[] zoneIds = {"Europe/Warsaw", "America/New_York", "Asia/Tokyo"};

        for (String id : zoneIds) {
            ZoneId zone = ZoneId.of(id);
            System.out.println(instant.atZone(zone));
        }
    }
}

Résultat

2024-07-01T14:00+02:00[Europe/Warsaw]
2024-07-01T08:00-04:00[America/New_York]
2024-07-01T21:00+09:00[Asia/Tokyo]

Chaque ligne représente le même instant fixé à l’avance : elle affiche la date et l’heure locales, le décalage UTC et l’identifiant régional entre crochets.

Leçons associées

  • Java · Leçon 59 · Intermédiaire · Version : 2

Sources