CKTIS / Java
`List.size()` i `List.get(int)`: odczyt dwóch przesunięć względem UTC
Sprawdź liczbę elementów listy przed odczytem według indeksu. Gdy cofnięcie zegara powoduje powtórzenie czasu lokalnego, odczytaj jawnie oba prawidłowe przesunięcia względem UTC.
Wersja: Java SE 21
Składnia
int size()
E get(int index)
int count = list.size();
E element = list.get(index); // 0 <= index && index < count, if the list has not changedW interfejsie java.util.List<E> metoda List.size() zwraca liczbę elementów jako int. Jeśli elementów jest więcej niż Integer.MAX_VALUE, zwraca Integer.MAX_VALUE. Metoda List.get(int) zwraca element typu E z podanej pozycji. Indeksy zaczynają się od zera: get(0) odczytuje pierwszy element, a nie liczbę elementów.
Indeks jest prawidłowy, gdy 0 <= index && index < list.size(). Indeks ujemny albo równy size() lub większy powoduje IndexOutOfBoundsException. Na pustej liście żaden indeks nie jest prawidłowy. Wcześniejsze sprawdzenie rozmiaru nie gwarantuje, że indeks nadal będzie prawidłowy, jeśli lista zmieni się przed odczytem.
ZoneRules.getValidOffsets(LocalDateTime) zwraca listę List<ZoneOffset>: 0 elementów w luce czasu lokalnego, 1 w zwykłym przypadku i zazwyczaj 2, gdy czas lokalny się powtarza. Dokumentacja dopuszcza teoretycznie więcej niż dwa przesunięcia. Gdy offsets.size() == 2, offsets.get(0) daje przesunięcie dla wcześniejszego wystąpienia tej samej daty i godziny lokalnej, a offsets.get(1) dla późniejszego. O kolejności decydują chwile w czasie, a nie rosnąca wartość przesunięcia.
Przykłady
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());
}
}Wynik
2 +02:00 +01:00
Przykład sam definiuje cofnięcie zegara z 03:00 na 02:00. Nie korzysta z zainstalowanej bazy stref czasowych. Po sprawdzeniu, że lista ma dokładnie dwa elementy, wypisuje ich liczbę, a następnie przesunięcia `+02:00` i `+01:00`.
Powiązane lekcje
- Java · Lekcja 60 · Zaawansowany · Wersja: 2
Źródła
- 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()