Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 changed

V 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