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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.