CKTIS / Java
ZoneId — identifikator vremenske zone
ZoneId identificira vremensku zonu, dok ZoneRules opisuje pravila njezina pomaka u odnosu na UTC. Upoznajte ZoneId.of, ZoneId.getRules i razliku između regije i fiksnog pomaka.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId identificira vremensku zonu; ne pohranjuje datum ni vrijeme. ZoneId.of(String) stvara identifikator regije, primjerice Europe/Paris, ili identifikator fiksnog pomaka, primjerice +02:00. Regija nije isto što i fiksni pomak.
ZoneId.getRules() vraća ZoneRules. Njegova metoda getOffset(Instant) daje pomak za određeni trenutak, dok isFixedOffset() provjerava mijenja li se taj pomak ikada. Pravila regija mogu uključivati promjene sata i ovise o podacima dostupnima u okruženju izvođenja.
Za Instant postoji jedan primjenjivi pomak. Međutim, pri pretvorbi LocalDateTime prijelaz pomaka može stvoriti prazninu ili preklapanje lokalnih vremena. getValidOffsets(LocalDateTime) pomaže prepoznati takve slučajeve; nemojte pretpostaviti da lokalno vrijeme uvijek određuje jedan trenutak.
Neispravan format predan metodi ZoneId.of uzrokuje DateTimeException, dok nepoznata regija uzrokuje ZoneRulesException. I ZoneId.getRules može baciti ZoneRulesException ako pravila nisu dostupna. Primjer upotrebljava fiksni pomak i određeni trenutak kako rezultat ne bi ovisio o satu ni o ažuriranjima podataka regija.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.