CKTIS / Java
`List.size()` und `List.get(int)`: zwei gültige UTC-Offsets auslesen
Prüfe vor dem Indexzugriff die Anzahl der Listenelemente. Wenn die Uhr zurückgestellt wird und eine Ortszeit doppelt vorkommt, lies beide gültigen UTC-Offsets gezielt aus.
Version: 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 changedBei java.util.List<E> liefert List.size() die Anzahl der Elemente als int. Enthält die Liste mehr als Integer.MAX_VALUE Elemente, liefert die Methode Integer.MAX_VALUE. List.get(int) liefert das Element vom Typ E an der angegebenen Position. Die Indizes beginnen bei null: get(0) liest das erste Element, nicht die Anzahl der Elemente.
Ein Index ist gültig, wenn 0 <= index && index < list.size(). Ein negativer Index oder ein Index ab size() löst eine IndexOutOfBoundsException aus. Eine leere Liste hat keinen gültigen Index. Eine vorherige Größenprüfung garantiert keinen gültigen Zugriff, wenn sich die Liste vor dem Lesen ändert.
ZoneRules.getValidOffsets(LocalDateTime) liefert eine List<ZoneOffset> mit 0 Elementen in einer Zeitlücke, 1 im Normalfall und üblicherweise 2 bei einer Überlappung, in der sich die Ortszeit wiederholt. Theoretisch erlaubt die API mehr als zwei Offsets. Gilt offsets.size() == 2, liefert offsets.get(0) den Offset zum früheren Auftreten desselben lokalen Datums und derselben Uhrzeit, offsets.get(1) den zum späteren Auftreten. Die Reihenfolge ist chronologisch, nicht nach aufsteigendem Zahlenwert des Offsets sortiert.
Beispiele
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());
}
}Ergebnis
2 +02:00 +01:00
Das Beispiel definiert eine eigene Zeitumstellung von 03:00 zurück auf 02:00. Es verwendet keine installierte Zeitzonendatenbank. Nachdem es geprüft hat, dass die Liste genau zwei Elemente enthält, gibt es deren Anzahl und anschließend `+02:00` und `+01:00` aus.
Zugehörige Lektionen
- Java · Lektion 60 · Fortgeschritten · Version: 2
Quellen
- 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()