CKTIS / Java
`List.size()` y `List.get(int)`: leer dos desfases UTC válidos
Comprueba cuántos elementos tiene una lista antes de acceder por índice. Si al atrasar el reloj se repite una hora local, lee explícitamente los dos desfases válidos respecto de UTC.
Versión: Java SE 21
Sintaxis
int size()
E get(int index)
int count = list.size();
E element = list.get(index); // 0 <= index && index < count, if the list has not changedEn java.util.List<E>, List.size() devuelve el número de elementos como un int. Si la lista contiene más de Integer.MAX_VALUE elementos, devuelve Integer.MAX_VALUE. List.get(int) devuelve el elemento de tipo E situado en la posición indicada. Los índices empiezan en cero: get(0) lee el primer elemento, no el número de elementos.
Un índice es válido si 0 <= index && index < list.size(). Un índice negativo, igual a size() o superior lanza IndexOutOfBoundsException. Una lista vacía no tiene ningún índice válido. Comprobar primero el tamaño no garantiza que el índice siga siendo válido si la lista cambia antes de la lectura.
ZoneRules.getValidOffsets(LocalDateTime) devuelve una List<ZoneOffset> con 0 elementos en un intervalo de horas inexistentes, 1 en el caso normal y normalmente 2 en un solapamiento, cuando se repite la hora local. La API contempla que, en teoría, pueda haber más de dos. Cuando offsets.size() == 2, offsets.get(0) da el desfase de la primera ocurrencia de la misma fecha y hora locales, y offsets.get(1) el de la segunda. El orden es cronológico, no ascendente según el valor numérico del desfase.
Ejemplos
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
El ejemplo define su propio atraso del reloj de 03:00 a 02:00. No consulta ninguna base de datos de zonas horarias instalada. Tras comprobar que la lista tiene exactamente dos elementos, imprime el número de elementos y después `+02:00` y `+01:00`.
Lecciones relacionadas
- Java · Lección 60 · Avanzado · Versión: 2
Fuentes
- 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()