CKTIS / Java
`List.size()` et `List.get(int)` : lire deux décalages UTC valides
Vérifiez le nombre d’éléments avant d’accéder à une liste par indice. Quand le recul de l’horloge fait apparaître deux fois une même heure locale, lisez explicitement les deux décalages UTC valides.
Version : Java SE 21
Syntaxe
int size()
E get(int index)
int count = list.size();
E element = list.get(index); // 0 <= index && index < count, if the list has not changedDans java.util.List<E>, List.size() renvoie le nombre d’éléments sous forme d’un int. Si la liste contient plus de Integer.MAX_VALUE éléments, la méthode renvoie Integer.MAX_VALUE. List.get(int) renvoie l’élément de type E à la position indiquée. Les indices commencent à zéro : get(0) lit le premier élément, pas le nombre d’éléments.
Un indice est valide si 0 <= index && index < list.size(). Un indice négatif, égal à size() ou supérieur à cette valeur provoque une IndexOutOfBoundsException. Une liste vide n’a aucun indice valide. Vérifier la taille au préalable ne garantit pas que l’indice reste valide si la liste change avant la lecture.
ZoneRules.getValidOffsets(LocalDateTime) renvoie une List<ZoneOffset> comportant 0 élément dans une plage d’heures inexistantes, 1 dans le cas normal et généralement 2 dans une plage d’heures répétées. L’API prévoit qu’il puisse théoriquement y en avoir plus de deux. Lorsque offsets.size() == 2, offsets.get(0) donne le décalage de la première occurrence de la même date et heure locales, et offsets.get(1) celui de la seconde. L’ordre est chronologique, et non croissant selon la valeur du décalage.
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(2);
ZoneOffset after = ZoneOffset.ofHours(1);
LocalDateTime cutoff = LocalDateTime.of(2024, 10, 27, 3, 0);
ZoneOffsetTransition rollback = ZoneOffsetTransition.of(cutoff, before, after);
ZoneRules rules = ZoneRules.of(after, before, List.of(), List.of(rollback), List.of());
LocalDateTime local = LocalDateTime.of(2024, 10, 27, 2, 30);
List<ZoneOffset> offsets = rules.getValidOffsets(local);
int count = offsets.size();
if (count != 2) {
throw new IllegalStateException("Expected exactly two valid offsets");
}
ZoneOffset earlier = offsets.get(0);
ZoneOffset later = offsets.get(1);
System.out.println(count);
System.out.println(earlier.getId());
System.out.println(later.getId());
}
}Résultat
2 +02:00 +01:00
L’exemple définit son propre recul de l’horloge de 03:00 à 02:00. Il ne consulte aucune base de données de fuseaux horaires installée. Après avoir vérifié que la liste contient exactement deux éléments, il affiche leur nombre, puis `+02:00` et `+01:00`.
Leçons associées
- Java · Leçon 60 · Avancé · Version : 2
Sources
- List (Java SE 21 & JDK 21) — get(int)
- List (Java SE 21 & JDK 21) — size()
- ZoneRules (Java SE 21 & JDK 21) — getValidOffsets(LocalDateTime)
- ZoneRules (Java SE 21 & JDK 21) — of(ZoneOffset, ZoneOffset, List, List, List)
- ZoneOffsetTransition (Java SE 21 & JDK 21) — of(LocalDateTime, ZoneOffset, ZoneOffset)
- ZoneOffset (Java SE 21 & JDK 21) — getId()