CKTIS / Java
ZoneRules — platné offsety a změny času
ZoneRules popisuje změny offsetu zóny. Metody getValidOffsets a getTransition umožňují zjistit neexistující nebo nejednoznačný místní čas ještě před výběrem offsetu.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);ZoneRules popisuje pravidla offsetů zóny. ZoneRules.getValidOffsets(LocalDateTime) vrací prázdný seznam při mezeře, obvykle jednu položku, nebo dvě při překryvu. Při překryvu je jako první uveden offset před přechodem; teoreticky mohou existovat i více než dva offsety.
ZoneRules.getTransition(LocalDateTime) vrací ZoneOffsetTransition při mezeře nebo překryvu, jinak null. Posunutí hodin dopředu vytváří neexistující místní časy; posunutí dozadu časy, které nastávají dvakrát. isGap() a isOverlap() tyto případy rozlišují. Nepředpokládejte, že přechod trvá jednu hodinu.
Stanovte si jednoznačnou politiku: mezeru odmítněte nebo čas upravte; při překryvu zvolte offset vědomě. Samotné getOffset(LocalDateTime) čas neověřuje: při mezerách a překryvech vrací offset před přechodem.
Pří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ýsledek
[] true [+02:00] true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.