CKTIS / Java
ZoneRules — geldige offsets en klokovergangen
ZoneRules beschrijft veranderingen in de offset van een zone. Met getValidOffsets en getTransition kun je niet-bestaande of dubbelzinnige lokale tijden herkennen voordat je een offset kiest.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
List<ZoneOffset> offsets = rules.getValidOffsets(localDateTime);
ZoneOffsetTransition transition = rules.getTransition(localDateTime);ZoneRules beschrijft de offsetregels van een zone. ZoneRules.getValidOffsets(LocalDateTime) geeft een lege lijst terug bij een gat, meestal één element of twee bij een overlap. Bij een overlap staat de offset van vóór de overgang als eerste; theoretisch zijn meer dan twee offsets mogelijk.
ZoneRules.getTransition(LocalDateTime) geeft bij een gat of overlap een ZoneOffsetTransition terug, en anders null. Klokken vooruitzetten creëert niet-bestaande lokale tijden; klokken terugzetten creëert tijden die twee keer voorkomen. isGap() en isOverlap() onderscheiden deze gevallen. Ga er niet van uit dat een overgang een uur duurt.
Leg een expliciet beleid vast: wijs een gat af of pas de tijd aan; kies bij een overlap bewust een offset. getOffset(LocalDateTime) valideert de tijd op zichzelf niet: bij gaten en overlappingen geeft het de offset van vóór de overgang terug.
Voorbeelden
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);
}
}Resultaat
[] true [+02:00] true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.