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.