База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници