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

CKTIS / Java

ZoneRules — offsets valides et transitions d’horloge

ZoneRules décrit les changements de l’offset d’une zone. Ses méthodes getValidOffsets et getTransition permettent de détecter les heures locales inexistantes ou ambiguës avant de choisir un offset.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);

ZoneRules décrit les règles d’offset d’une zone. ZoneRules.getValidOffsets(LocalDateTime) renvoie une liste vide pour une lacune, normalement un élément, ou deux en cas de chevauchement. Dans un chevauchement, l’offset antérieur à la transition apparaît en premier ; il est théoriquement possible d’avoir plus de deux offsets.

ZoneRules.getTransition(LocalDateTime) renvoie une ZoneOffsetTransition pour une lacune ou un chevauchement, et null dans les autres cas. Avancer les horloges crée des heures locales inexistantes ; les reculer crée des heures qui se produisent deux fois. isGap() et isOverlap() distinguent ces cas. Ne supposez pas qu’une transition dure une heure.

Définissez une politique explicite : rejetez une lacune ou ajustez l’heure ; en cas de chevauchement, choisissez délibérément un offset. getOffset(LocalDateTime) ne valide pas l’heure à lui seul : pour les lacunes et les chevauchements, il renvoie l’offset antérieur à la transition.

Exemples

import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.zone.ZoneOffsetTransition;
import java.time.zone.ZoneRules;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        ZoneOffset before = ZoneOffset.ofHours(1);
        ZoneOffset after = ZoneOffset.ofHours(2);
        ZoneOffsetTransition jump = ZoneOffsetTransition.of(
                LocalDateTime.of(2024, 3, 31, 2, 0), before, after);
        ZoneRules rules = ZoneRules.of(
                before, before, List.of(), List.of(jump), List.of());

        LocalDateTime local = LocalDateTime.of(2024, 3, 31, 2, 30);
        System.out.println(rules.getValidOffsets(local));
        ZoneOffsetTransition transition = rules.getTransition(local);
        System.out.println(transition != null && transition.isGap());
        System.out.println(rules.getValidOffsets(local.plusHours(1)));
        System.out.println(rules.getTransition(local.plusHours(1)) == null);
    }
}

Résultat

[]
true
[+02:00]
true

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.

Sources