Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

ZoneRules — platné offsety a zmeny času

ZoneRules opisuje zmeny offsetu zóny. Metódy getValidOffsets a getTransition umožňujú zistiť neexistujúci alebo nejednoznačný miestny čas ešte pred výberom offsetu.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);

ZoneRules opisuje pravidlá offsetov zóny. ZoneRules.getValidOffsets(LocalDateTime) vracia prázdny zoznam pri medzere, zvyčajne jednu položku alebo dve pri prekrytí. Pri prekrytí je ako prvý uvedený offset pred prechodom; teoreticky môžu existovať aj viac než dva offsety.

ZoneRules.getTransition(LocalDateTime) vracia ZoneOffsetTransition pri medzere alebo prekrytí, inak null. Posunutie hodín dopredu vytvára neexistujúce miestne časy; posunutie dozadu časy, ktoré nastávajú dvakrát. isGap() a isOverlap() tieto prípady rozlišujú. Nepredpokladajte, že prechod trvá jednu hodinu.

Stanovte si jednoznačnú politiku: medzeru odmietnite alebo čas upravte; pri prekrytí zvoľte offset vedome. Samotné getOffset(LocalDateTime) čas neoveruje: pri medzerách a prekrytiach vracia offset pred prechodom.

Príklady

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);
    }
}

Výsledok

[]
true
[+02:00]
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje