Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

`List.size()` e `List.get(int)`: ler dois desfasamentos UTC válidos

Verifica quantos elementos tem uma lista antes de aceder por índice. Quando o recuo do relógio faz repetir uma hora local, lê explicitamente os dois desfasamentos válidos em relação a UTC.

Versão: Java SE 21

Sintaxe

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

Em java.util.List<E>, List.size() devolve o número de elementos como um int. Se a lista tiver mais de Integer.MAX_VALUE elementos, devolve Integer.MAX_VALUE. List.get(int) devolve o elemento do tipo E na posição indicada. Os índices começam em zero: get(0) lê o primeiro elemento e não o número de elementos.

Um índice é válido quando 0 <= index && index < list.size(). Um índice negativo, igual a size() ou superior lança IndexOutOfBoundsException. Uma lista vazia não tem índices válidos. Verificar primeiro o tamanho não garante que o índice continue válido se a lista mudar antes da leitura.

ZoneRules.getValidOffsets(LocalDateTime) devolve uma List<ZoneOffset> com 0 elementos num intervalo de horas inexistentes, 1 no caso normal e normalmente 2 numa sobreposição, quando a hora local se repete. Em teoria, a API admite mais do que dois. Quando offsets.size() == 2, offsets.get(0) dá o desfasamento da primeira ocorrência da mesma data e hora locais, e offsets.get(1) dá o da segunda. A ordem é cronológica e não crescente por valor numérico do desfasamento.

Exemplos

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());
    }
}

Resultado

2
+02:00
+01:00

O exemplo define um recuo do relógio das 03:00 para as 02:00. Não consulta uma base de dados de fusos horários instalada. Depois de verificar que a lista contém exatamente dois elementos, escreve o número de elementos, seguido de `+02:00` e `+01:00`.

Lições relacionadas

  • Java · Lição 60 · Avançado · Versão: 2

Fontes