CKTIS / Java
ZoneRules — poprawne offsety i zmiany czasu
ZoneRules opisuje zmiany offsetu strefy. Metody getValidOffsets i getTransition pozwalają wykrywać nieistniejący lub niejednoznaczny czas lokalny przed wyborem offsetu.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);ZoneRules opisuje reguły offsetu strefy. ZoneRules.getValidOffsets(LocalDateTime) zwraca listę: pustą dla luki, jednoelementową zwykle, dwuelementową dla nałożenia. W nałożeniu offset sprzed zmiany jest pierwszy; teoretycznie możliwe są ponad dwa offsety.
ZoneRules.getTransition(LocalDateTime) zwraca ZoneOffsetTransition dla luki lub nałożenia, a poza nimi null. Przesunięcie zegara naprzód tworzy nieistniejące czasy lokalne; cofnięcie — czasy występujące dwukrotnie. isGap() i isOverlap() rozróżniają te przypadki. Nie zakładaj, że zmiana trwa godzinę.
Ustal jawną politykę: odrzucaj lukę lub koryguj czas; przy nałożeniu wybieraj offset świadomie. Samo getOffset(LocalDateTime) nie waliduje czasu: dla luki i nałożenia zwraca offset sprzed zmiany.
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(1);
ZoneOffset after = ZoneOffset.ofHours(2);
ZoneOffsetTransition jump = ZoneOffsetTransition.of(
LocalDateTime.of(2024, 3, 31, 2, 0), before, after);
ZoneRules rules = ZoneRules.of(
before, before, List.of(), List.of(jump), List.of());
LocalDateTime local = LocalDateTime.of(2024, 3, 31, 2, 30);
System.out.println(rules.getValidOffsets(local));
ZoneOffsetTransition transition = rules.getTransition(local);
System.out.println(transition != null && transition.isGap());
System.out.println(rules.getValidOffsets(local.plusHours(1)));
System.out.println(rules.getTransition(local.plusHours(1)) == null);
}
}Wynik
[] true [+02:00] true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.