CKTIS / Java
`List.size()` a `List.get(int)`: čtení dvou platných posunů vůči UTC
Před přístupem podle indexu ověř počet prvků seznamu. Když se při posunu hodin zpět místní čas opakuje, načti výslovně oba platné posuny vůči UTC.
Verze: 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 changedV rozhraní java.util.List<E> vrací List.size() počet prvků jako int. Pokud seznam obsahuje více než Integer.MAX_VALUE prvků, vrátí Integer.MAX_VALUE. List.get(int) vrací prvek typu E na zadané pozici. Indexy začínají nulou: get(0) čte první prvek, nikoli počet prvků.
Index je platný, pokud 0 <= index && index < list.size(). Záporný index nebo index rovný size() či vyšší vyvolá IndexOutOfBoundsException. Prázdný seznam nemá žádný platný index. Kontrola velikosti předem nezaručuje, že index zůstane platný, pokud se seznam před čtením změní.
ZoneRules.getValidOffsets(LocalDateTime) vrací List<ZoneOffset> s 0 prvky v přeskočeném úseku místního času, s 1 prvkem v běžném případě a zpravidla se 2 prvky při překryvu, kdy se místní čas opakuje. Teoreticky API připouští více než dva posuny. Pokud offsets.size() == 2, offsets.get(0) vrátí posun pro dřívější výskyt téhož místního data a času a offsets.get(1) pro pozdější. Pořadí je chronologické, nikoli vzestupné podle číselné hodnoty posunu.
Příklady
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());
}
}Výsledek
2 +02:00 +01:00
Příklad sám definuje posun hodin z 03:00 zpět na 02:00. Nepoužívá nainstalovanou databázi časových pásem. Po ověření, že seznam obsahuje přesně dva prvky, vypíše jejich počet a poté `+02:00` a `+01:00`.
Související lekce
- Java · Lekce 60 · Pokročilá · Verze: 2
Zdroje
- 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()