Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

ZoneRules — veljavni odmiki in premiki ure

ZoneRules opisuje spremembe odmika časovnega pasu. Metodi getValidOffsets in getTransition omogočata zaznati neobstoječe ali dvoumne lokalne čase, preden izberemo odmik.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

ZoneRules opisuje pravila odmika časovnega pasu. ZoneRules.getValidOffsets(LocalDateTime) vrne prazen seznam pri vrzeli, običajno en element ali dva pri prekrivanju. Pri prekrivanju je najprej naveden odmik pred prehodom; teoretično je možnih več kot dva odmika.

ZoneRules.getTransition(LocalDateTime) vrne ZoneOffsetTransition pri vrzeli ali prekrivanju, sicer null. Premik ure naprej ustvari neobstoječe lokalne čase, premik nazaj pa čase, ki nastopijo dvakrat. isGap() in isOverlap() razlikujeta ta primera. Ne predpostavljajte, da prehod traja eno uro.

Določite izrecno politiko: vrzel zavrnite ali prilagodite čas; pri prekrivanju odmik izberite premišljeno. Sam getOffset(LocalDateTime) časa ne preveri: pri vrzelih in prekrivanjih vrne odmik pred prehodom.

Primeri

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

Rezultat

[]
true
[+02:00]
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri