Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

ZoneRules — valjani pomaci i promjene sata

ZoneRules opisuje promjene pomaka vremenske zone. Metode getValidOffsets i getTransition otkrivaju nepostojeća ili dvosmislena lokalna vremena prije odabira pomaka.

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

Sintaksa

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

ZoneRules opisuje pravila pomaka vremenske zone. ZoneRules.getValidOffsets(LocalDateTime) vraća prazan popis za prazninu, obično jedan element ili dva za preklapanje. Kod preklapanja prvi je pomak prije prijelaza; teoretski je moguće više od dva pomaka.

ZoneRules.getTransition(LocalDateTime) vraća ZoneOffsetTransition za prazninu ili preklapanje, a inače null. Pomicanje sata unaprijed stvara nepostojeća lokalna vremena; pomicanje unatrag stvara vremena koja se pojavljuju dvaput. isGap() i isOverlap() razlikuju te slučajeve. Nemojte pretpostaviti da prijelaz traje jedan sat.

Odredite izričitu politiku: odbacite prazninu ili prilagodite vrijeme; kod preklapanja svjesno odaberite pomak. Sam getOffset(LocalDateTime) ne provjerava valjanost vremena: za praznine i preklapanja vraća pomak prije prijelaza.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori