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

CKTIS / Java

ZonedDateTime: същият момент или същият местен час?

В Java 21 създайте дата и час с часова зона, изберете изрично всяко от двете появявания на повторен местен час и решете какво да се запази при смяна на зоната.

Версия: Java SE 21

Синтаксис

java.time.ZonedDateTime — Java SE 21

public static ZonedDateTime of(LocalDateTime localDateTime, ZoneId zone)
public static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
public static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
public static ZonedDateTime ofLocal(LocalDateTime localDateTime, ZoneId zone, ZoneOffset preferredOffset)
public ZonedDateTime withZoneSameInstant(ZoneId zone)
public ZonedDateTime withZoneSameLocal(ZoneId zone)

java.time.ZonedDateTime съчетава местна дата и час с идентификатор на часова зона (ZoneId) и отместване спрямо UTC (ZoneOffset). Instant е точка върху времевата ос. Местната дата и час са показанията на календара и часовника; в дадена зона те могат да означават два различни момента.

ZonedDateTime.of е статичен фабричен метод с три претоварвания: приема LocalDateTime, двойка LocalDate и LocalTime или седем числови полета, винаги заедно с ZoneId. При едно валидно отместване използва него. При припокриване, когато местният интервал се повтаря, избира отместването за първото появяване. При пропуск, когато местният интервал е прескочен, премества местната дата и час напред с продължителността на пропуска и използва отместването след прехода. Невалидни полета за дата или час в числовото претоварване предизвикват DateTimeException.

ZonedDateTime.ofLocal(localDateTime, zone, preferredOffset) е статичен фабричен метод. При припокриване използва предпочитаното отместване само ако то е едно от двете валидни. При null или несъвпадащо отместване избира първото появяване. При едно валидно отместване или при пропуск се държи като of. Предпочитанието не е проверка за валидност: ако приложението трябва да отхвърля пропуски или да изисква изричен избор при припокриване, проверете zone.getRules().getValidOffsets(localDateTime), който връща 0, 1 или 2 отмествания.

ZonedDateTime.withZoneSameInstant(zone) показва същото събитие в друга зона: toInstant() дава равна стойност, дори ако местната дата или час се променят. Не се налага да се разрешават местни пропуски или припокривания; резултат извън поддържания диапазон от дати предизвиква DateTimeException. ZonedDateTime.withZoneSameLocal(zone) приема същата дата и час за местни в целевата зона, така че моментът може да се промени. Следва правилата на ofLocal, като предпочита текущото отместване. При пропуск не може да запази първоначалната местна дата и час. Нито един от двата метода не променя първоначалния обект.

Примери

import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;

public class ZonedDateTimeTransform {
    public static void main(String[] args) {
        ZoneId paris = ZoneId.of("Europe/Paris");
        LocalDateTime wallTime = LocalDateTime.of(2024, 10, 27, 2, 30);

        ZonedDateTime defaultChoice = ZonedDateTime.of(wallTime, paris);
        ZonedDateTime earlier = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(2));
        ZonedDateTime later = ZonedDateTime.ofLocal(wallTime, paris, ZoneOffset.ofHours(1));

        System.out.println("of: " + defaultChoice);
        System.out.println("ofLocal +02:00: " + earlier + " -> " + earlier.toInstant());
        System.out.println("ofLocal +01:00: " + later + " -> " + later.toInstant());
        System.out.println("same instant: " + earlier.withZoneSameInstant(ZoneOffset.UTC));
        System.out.println("same local: " + earlier.withZoneSameLocal(ZoneOffset.UTC));
    }
}

Резултат

of: 2024-10-27T02:30+02:00[Europe/Paris]
ofLocal +02:00: 2024-10-27T02:30+02:00[Europe/Paris] -> 2024-10-27T00:30:00Z
ofLocal +01:00: 2024-10-27T02:30+01:00[Europe/Paris] -> 2024-10-27T01:30:00Z
same instant: 2024-10-27T00:30Z
same local: 2024-10-27T02:30Z

По правилата за `Europe/Paris` в примера `02:30` се появява два пъти: `+02:00` дава `00:30Z`, а `+01:00` дава `01:30Z`. `of` избира първото появяване; двете извиквания на `ofLocal` избират изрично и двете отмествания. При преобразуване на първото появяване към UTC се получава `00:30Z`, ако се запази моментът, или `02:30Z`, ако се запази показанието на часовника. Резултатите за регионална зона зависят от правилата, налични в средата за изпълнение.

Свързани уроци

  • Java · Урок 60 · Напреднало · Версия: 2

Източници