CKTIS / Java
ZoneId — идентификатор на часова зона
ZoneId идентифицира часова зона, а ZoneRules описва правилата за отместването ѝ спрямо UTC. Научете за ZoneId.of, ZoneId.getRules и разликата между регион и фиксирано отместване.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
ZoneId zone = ZoneId.of("+02:00");
ZoneRules rules = zone.getRules();java.time.ZoneId идентифицира часова зона; не съхранява дата или час. ZoneId.of(String) създава идентификатор на регион, например Europe/Paris, или на фиксирано отместване, например +02:00. Регионът не е същото като фиксирано отместване.
ZoneId.getRules() връща ZoneRules. Методът getOffset(Instant) предоставя отместването за конкретен момент, а isFixedOffset() проверява дали то никога не се променя. Правилата за регионите може да включват промени на часовника и зависят от данните, налични в средата за изпълнение.
За даден Instant има едно приложимо отместване. При преобразуване на LocalDateTime обаче преходът между отместванията може да създаде празнина или застъпване в местните часове. getValidOffsets(LocalDateTime) помага да се открият тези случаи; не приемайте, че местният час винаги обозначава един момент.
Невалиден формат, подаден на ZoneId.of, причинява DateTimeException, а непознат регион причинява ZoneRulesException. ZoneId.getRules също може да хвърли ZoneRulesException, ако правилата не са налични. Примерът използва фиксирано отместване и зададен момент, така че резултатът да не зависи от часовника или от актуализациите на регионалните данни.
Примери
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));
}
}Резултат
+02:00 true +02:00
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.