CKTIS / Java
`List.size()` en `List.get(int)`: twee geldige UTC-offsets uitlezen
Controleer hoeveel elementen een lijst bevat voordat je een index gebruikt. Als de klok wordt teruggezet en een lokale tijd twee keer voorkomt, lees je beide geldige UTC-offsets expliciet uit.
Versie: Java SE 21
Syntax
int size()
E get(int index)
int count = list.size();
E element = list.get(index); // 0 <= index && index < count, if the list has not changedBij java.util.List<E> geeft List.size() het aantal elementen terug als int. Bevat de lijst meer dan Integer.MAX_VALUE elementen, dan geeft de methode Integer.MAX_VALUE terug. List.get(int) geeft het element van type E op de opgegeven positie terug. Indexen beginnen bij nul: get(0) leest het eerste element, niet het aantal elementen.
Een index is geldig als 0 <= index && index < list.size(). Een negatieve index of een index die gelijk is aan of groter is dan size(), veroorzaakt een IndexOutOfBoundsException. Een lege lijst heeft geen geldige index. Als de lijst vóór het lezen verandert, garandeert een eerdere controle van de grootte niet dat de index geldig blijft.
ZoneRules.getValidOffsets(LocalDateTime) geeft een List<ZoneOffset> terug met 0 elementen voor overgeslagen lokale tijden, 1 in het normale geval en doorgaans 2 bij een overlap waarin de lokale tijd zich herhaalt. De API laat in theorie meer dan twee toe. Als offsets.size() == 2, geeft offsets.get(0) de offset voor het eerste voorkomen van dezelfde lokale datum en tijd, en offsets.get(1) die voor het tweede. De volgorde is chronologisch, niet oplopend op numerieke offset.
Voorbeelden
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());
}
}Resultaat
2 +02:00 +01:00
Het voorbeeld definieert zelf een terugzetting van de klok van 03:00 naar 02:00. Het raadpleegt geen geïnstalleerde tijdzonedatabase. Nadat het heeft gecontroleerd dat de lijst precies twee elementen bevat, drukt het het aantal af, gevolgd door `+02:00` en `+01:00`.
Gerelateerde lessen
- Java · Les 60 · Gevorderd · Versie: 2
Bronnen
- 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()