CKTIS / Java
`List.size()` e `List.get(int)`: leggere due scostamenti UTC validi
Controlla quanti elementi contiene una lista prima di accedere per indice. Quando le lancette tornano indietro e un orario locale si ripete, leggi esplicitamente entrambi gli scostamenti validi rispetto a UTC.
Versione: Java SE 21
Sintassi
int size()
E get(int index)
int count = list.size();
E element = list.get(index); // 0 <= index && index < count, if the list has not changedIn java.util.List<E>, List.size() restituisce il numero di elementi come int. Se la lista contiene più di Integer.MAX_VALUE elementi, restituisce Integer.MAX_VALUE. List.get(int) restituisce l’elemento di tipo E nella posizione indicata. Gli indici partono da zero: get(0) legge il primo elemento, non il numero di elementi.
Un indice è valido se 0 <= index && index < list.size(). Un indice negativo, uguale a size() o maggiore causa un’eccezione IndexOutOfBoundsException. Una lista vuota non ha indici validi. Controllare prima la dimensione non garantisce che l’indice rimanga valido se la lista cambia prima della lettura.
ZoneRules.getValidOffsets(LocalDateTime) restituisce una List<ZoneOffset> con 0 elementi in un intervallo di orari inesistenti, 1 nel caso normale e di solito 2 in una sovrapposizione, quando l’orario locale si ripete. In teoria, l’API ne ammette più di due. Quando offsets.size() == 2, offsets.get(0) dà lo scostamento della prima occorrenza della stessa data e ora locali, mentre offsets.get(1) dà quello della seconda. L’ordine è cronologico, non crescente per valore numerico dello scostamento.
Esempi
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());
}
}Risultato
2 +02:00 +01:00
L’esempio definisce un proprio passaggio all’indietro dalle 03:00 alle 02:00. Non consulta alcun database dei fusi orari installato. Dopo aver controllato che la lista contenga esattamente due elementi, ne stampa il numero e poi `+02:00` e `+01:00`.
Lezioni correlate
- Java · Lezione 60 · Avanzato · Versione: 2
Fonti
- 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()