CKTIS / Java
ZoneId — identifikator časovnega pasu
ZoneId določa časovni pas, ZoneRules pa opisuje njegova pravila odmika od UTC. Spoznajte ZoneId.of, ZoneId.getRules in razliko med regijo ter fiksnim odmikom.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId določa časovni pas; datuma ali časa ne shranjuje. ZoneId.of(String) ustvari identifikator regije, na primer Europe/Paris, ali identifikator fiksnega odmika, na primer +02:00. Regija ni isto kot fiksni odmik.
ZoneId.getRules() vrne ZoneRules. Njegova metoda getOffset(Instant) poda odmik za določen trenutek, medtem ko isFixedOffset() preveri, ali se ta odmik nikoli ne spremeni. Pravila regij lahko vključujejo spremembe ure in so odvisna od podatkov, ki so na voljo v izvajalnem okolju.
Za Instant velja en sam ustrezen odmik. Pri pretvorbi LocalDateTime pa lahko prehod med odmiki povzroči vrzel ali prekrivanje lokalnih časov. getValidOffsets(LocalDateTime) pomaga prepoznati te primere; ne predpostavljajte, da lokalni čas vedno določa en sam trenutek.
Neveljavna oblika, podana metodi ZoneId.of, povzroči DateTimeException, neznana regija pa ZoneRulesException. Tudi ZoneId.getRules lahko sproži ZoneRulesException, če pravila niso na voljo. Primer uporablja fiksni odmik in določen trenutek, zato izpis ni odvisen od ure ali posodobitev podatkov regij.
Primeri
import java.time.Instant;
import java.time.ZoneId;
import java.time.zone.ZoneRules;
public class Main {
public static void main(String[] args) {
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();
Instant instant = Instant.parse("2024-01-15T12:00:00Z");
System.out.println(zone.getId());
System.out.println(rules.isFixedOffset());
System.out.println(rules.getOffset(instant));
}
}Rezultat
+02:00 true +02:00
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.