CKTIS / Java
ZoneId — un identifiant de fuseau horaire
ZoneId identifie un fuseau horaire, tandis que ZoneRules décrit ses règles de décalage par rapport à UTC. Découvrez ZoneId.of, ZoneId.getRules et la différence entre une région et un décalage fixe.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId identifie un fuseau horaire ; il ne stocke ni date ni heure. ZoneId.of(String) crée un identifiant de région, comme Europe/Paris, ou un identifiant de décalage fixe, comme +02:00. Une région n’est pas la même chose qu’un décalage fixe.
ZoneId.getRules() renvoie ZoneRules. Sa méthode getOffset(Instant) fournit le décalage applicable à un instant donné, tandis que isFixedOffset() vérifie si ce décalage ne change jamais. Les règles régionales peuvent prendre en compte les changements d’heure et dépendent des données disponibles dans l’environnement d’exécution.
Un Instant correspond à un seul décalage applicable. Lors de la conversion d’un LocalDateTime, une transition de décalage peut toutefois créer une lacune ou un chevauchement dans les heures locales. getValidOffsets(LocalDateTime) aide à repérer ces cas ; ne supposez pas qu’une heure locale désigne toujours un seul instant.
Un format incorrect transmis à ZoneId.of provoque une DateTimeException, tandis qu’une région inconnue provoque une ZoneRulesException. ZoneId.getRules peut également lever une ZoneRulesException si les règles ne sont pas disponibles. L’exemple utilise un décalage fixe et un instant déterminé afin que son résultat ne dépende ni de l’horloge ni des mises à jour des données régionales.
Exemples
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));
}
}Résultat
+02:00 true +02:00
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.