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

CKTIS / Java

ZonedDateTime — дата и час с часова зона

ZonedDateTime съчетава местни дата и час, часова зона и разрешено отместване спрямо UTC. Разграничава смяната на зоната със запазване на момента от запазването на местното време и обработва нееднозначностите при смяна на часа.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

ZonedDateTime.of(localDateTime, zone)
ZonedDateTime.ofInstant(instant, zone)
ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset)
zdt.withZoneSameInstant(zone)
zdt.withZoneSameLocal(zone)
zdt.toInstant()
zdt.format(formatter)
zdt.with(adjuster)
zdt.with(field, value)
zdt.withHour(hour)
zdt.withMinute(minute)

ZonedDateTime е неизменяема и безопасна за използване от нишки ISO стойност за дата и час с ZoneId и ZoneOffset. Регионалната зона задава правила за промени в отместването; фиксираното отместване няма такива промени.

ZonedDateTime.of създава стойност от местни дата и час и зона. При празнина премества часа напред с продължителността на празнината; при застъпване избира по-ранното отместване. ZonedDateTime.ofLocal приема и предпочитано отместване: използва го, ако е валидно, а в противен случай избира по-ранното; null означава, че няма предпочитание. Разрешава празнините по същия начин. ZonedDateTime.ofInstant(instant, zone) запазва зададения момент без тази нееднозначност.

ZonedDateTime.withZoneSameInstant запазва момента и обикновено променя местния час. ZonedDateTime.withZoneSameLocal запазва, ако е възможно, местните дата и час и прилага правилата на ofLocal; моментът може да се промени. ZonedDateTime.toInstant връща само момента, без идентификатора на зоната, а ZonedDateTime.format форматира стойността чрез DateTimeFormatter.

ZonedDateTime.with(adjuster) прилага TemporalAdjuster, а ZonedDateTime.with(field, value) задава поле. ZonedDateTime.withHour задава часа в диапазона 0–23, а ZonedDateTime.withMinute — минутата в диапазона 0–59. Запазете върнатата стойност: оригиналът не се променя. Местните промени на часа или минутата също следват правилата за празнини и застъпвания; те не означават прибавяне на изминала продължителност.

Примери

import java.time.*;
import java.time.format.DateTimeFormatter;

public class Main {
    public static void main(String[] args) {
        ZoneId source = ZoneOffset.ofHours(1);
        ZoneId target = ZoneOffset.ofHours(-5);
        LocalDateTime local = LocalDateTime.of(2024, 1, 15, 12, 0);
        ZonedDateTime original = ZonedDateTime.of(local, source);
        ZonedDateTime sameInstant = original.withZoneSameInstant(target);
        ZonedDateTime sameLocal = original.withZoneSameLocal(target);

        System.out.println(sameInstant.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
        System.out.println(sameLocal.format(DateTimeFormatter.ISO_ZONED_DATE_TIME));
        System.out.println(original.toInstant().equals(sameInstant.toInstant()));
        System.out.println(original.toInstant().equals(sameLocal.toInstant()));
    }
}

Резултат

2024-01-15T06:00:00-05:00
2024-01-15T12:00:00-05:00
true
false

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

Източници