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.