CKTIS / Java
ZoneRules — валидни отмествания и промени на часовника
ZoneRules описва промените в отместването на часовата зона. Методите getValidOffsets и getTransition откриват несъществуващи или двусмислени местни часове, преди да бъде избрано отместване.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);ZoneRules описва правилата за отместването на дадена зона. ZoneRules.getValidOffsets(LocalDateTime) връща празен списък при пропуск, обикновено един елемент или два при припокриване. При припокриване първо е отместването отпреди прехода; теоретично са възможни повече от две отмествания.
ZoneRules.getTransition(LocalDateTime) връща ZoneOffsetTransition при пропуск или припокриване, а в останалите случаи — null. Преместването на часовника напред създава несъществуващи местни часове; връщането му назад създава часове, които се срещат два пъти. isGap() и isOverlap() разграничават тези случаи. Не приемайте, че преходът трае един час.
Задайте ясна политика: отхвърлете пропуск или коригирайте часа; при припокриване изберете отместване съзнателно. Самостоятелно getOffset(LocalDateTime) не проверява часа: при пропуски и припокривания връща отместването отпреди прехода.
Примери
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);
}
}Резултат
[] true [+02:00] true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.