CKTIS / Java
`List.size()` и `List.get(int)`: прочитане на две валидни отмествания спрямо UTC
Провери броя на елементите в списъка преди достъп по индекс. Когато връщането на часовника повтаря местен час, прочети изрично и двете валидни отмествания спрямо UTC.
Версия: Java SE 21
Синтаксис
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В интерфейса java.util.List<E> методът List.size() връща броя на елементите като int. Ако списъкът съдържа повече от Integer.MAX_VALUE елемента, методът връща Integer.MAX_VALUE. List.get(int) връща елемента от тип E на посочената позиция. Индексите започват от нула: get(0) прочита първия елемент, а не броя на елементите.
Индексът е валиден, когато 0 <= index && index < list.size(). Отрицателен индекс или индекс, равен на size() или по-голям от него, предизвиква IndexOutOfBoundsException. Празният списък няма валиден индекс. Предварителната проверка на размера не гарантира, че индексът ще остане валиден, ако списъкът се промени преди прочитането.
ZoneRules.getValidOffsets(LocalDateTime) връща List<ZoneOffset> с 0 елемента в пропуснат интервал от местното време, с 1 елемент в обичайния случай и обикновено с 2 елемента при припокриване, когато местното време се повтаря. API теоретично допуска повече от две отмествания. Когато offsets.size() == 2, offsets.get(0) дава отместването при по-ранното настъпване на същите местни дата и час, а offsets.get(1) — при по-късното. Редът е хронологичен, а не възходящ според числовата стойност на отместването.
Примери
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());
}
}Резултат
2 +02:00 +01:00
Примерът сам задава връщане на часовника от 03:00 на 02:00. Той не използва инсталирана база данни за часовите зони. След като провери, че списъкът съдържа точно два елемента, извежда броя им, а след това `+02:00` и `+01:00`.
Свързани уроци
- Java · Урок 60 · Напреднало · Версия: 2
Източници
- 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()