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

CKTIS / Java

ZoneOffsetTransition — lacunes et chevauchements de l’heure locale

ZoneOffsetTransition décrit un changement de décalage UTC. La méthode isGap() détecte une lacune, tandis que getDateTimeAfter() renvoie la date et l’heure locales à la limite de la transition avec le nouveau décalage.

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

Syntaxe

boolean gap = transition.isGap();
LocalDateTime after = transition.getDateTimeAfter();

ZoneOffsetTransition modélise un changement de décalage UTC. isGap() renvoie true en cas de lacune : les heures locales sautées n’existent pas. Le résultat false indique un chevauchement : certaines heures locales se produisent deux fois.

getDateTimeAfter() renvoie la LocalDateTime à la limite de la transition avec le nouveau décalage, et non un Instant. Lorsque l’horloge recule, le résultat est antérieur à getDateTimeBefore(). L’écart entre l’ancien et le nouveau décalage UTC n’est pas nécessairement d’une heure.

Les applications devraient normalement utiliser ZoneRules.getTransition(localDateTime) ; vérifiez la valeur null avant d’appeler des méthodes, car une heure locale ordinaire n’a pas de transition. L’exemple utilise of() uniquement pour une démonstration déterministe ; cette fabrique sert à construire des ZoneRules, et non à rechercher des changements réels de fuseau horaire.

Identifiants de référence couverts par cette entrée : ZoneOffsetTransition.isGap, ZoneOffsetTransition.getDateTimeAfter.

Exemples

import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.zone.ZoneOffsetTransition;

public class Main {
    public static void main(String[] args) {
        ZoneOffsetTransition transition = ZoneOffsetTransition.of(
            LocalDateTime.of(2024, 3, 31, 2, 0),
            ZoneOffset.ofHours(1),
            ZoneOffset.ofHours(2)
        );
        System.out.println(transition.isGap());
        System.out.println(transition.getDateTimeAfter());
    }
}

Résultat

true
2024-03-31T03: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.

Sources