База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници