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 changedEm 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
- 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()