ZonedDateTime: примеры (JAVA)

Короткие примеры использования

import java.time.*;

// 1. Текущее время в зоне
ZonedDateTime now = ZonedDateTime.now(ZoneId.of("Europe/Moscow"));
System.out.println(now);

2024-12-01T10:15:30.123456789+03:00[Europe/Moscow]

// 2. Создание ZonedDateTime из компонентов
ZonedDateTime meeting = ZonedDateTime.of(2025, 6, 15, 9, 0, 0, 0, ZoneId.of("America/New_York"));
System.out.println(meeting);

2025-06-15T09:00-04:00[America/New_York]

// 3. Парсинг строки
ZonedDateTime parsed = ZonedDateTime.parse("2024-12-01T10:15:30+03:00[Europe/Moscow]");
System.out.println(parsed);

2024-12-01T10:15:30+03:00[Europe/Moscow]

// 4. Преобразование Instant в ZonedDateTime
Instant instant = Instant.now();
ZonedDateTime fromInstant = ZonedDateTime.ofInstant(instant, ZoneOffset.UTC);
System.out.println(fromInstant);

2024-12-01T07:15:30Z[UTC]

Похожие функции в Java

• OffsetDateTime - дата и время с фиксированным смещением от UTC (без учёта DST). Используется, когда нужна только информация о смещении, а не полные правила зоны.
• LocalDateTime - дата и время без привязки к зоне. Удобен для локальных событий (например, день рождения) или когда зона не важна.
• Instant - момент на временной шкале в UTC. Подходит для хранения временных меток без учёта зоны.
• ZonedDateTime предпочтительнее, когда необходимо учитывать летнее время, исторические изменения зоны или выполнять операции, зависящие от правил зоны (например, смещение через день).

Выбор между ними определяется требованиями к точности временной привязки.

Альтернативы в других языках

• Python (модуль zoneinfo):

  from datetime import datetime
  from zoneinfo import ZoneInfo
  dt = datetime(2024, 12, 1, 10, 15, tzinfo=ZoneInfo("Europe/Moscow"))

• JavaScript (Intl.DateTimeFormat):

  const date = new Date();
  const formatter = new Intl.DateTimeFormat('ru-RU', { timeZone: 'Europe/Moscow' });
  formatter.format(date);

• PHP (DateTimeZone):

  $dt = new DateTime('now', new DateTimeZone('Europe/Moscow'));

• C# (DateTimeOffset):

  var dto = new DateTimeOffset(2024, 12, 1, 10, 15, 0, TimeSpan.FromHours(3));

• Go (time.Location):

  loc, _ := time.LoadLocation("Europe/Moscow")
  t := time.Date(2024, 12, 1, 10, 15, 0, 0, loc)

• SQL (TIMESTAMP WITH TIME ZONE):

  SELECT '2024-12-01 10:15:30 +03:00'::timestamptz;

Главное отличие: в Java класс полностью неизменяемый, в Python объект datetime с tzinfo может быть частично мутабельным, в JavaScript нет полноценного типа для времени с зоной - используются строки и Intl.

Типичные ошибки

• Некорректный ZoneId: ZoneId.of("неверная") вызывает DateTimeException.

  try { ZoneId.of("Invalid/Zone"); } catch (DateTimeException e) { e.printStackTrace(); }

  java.time.DateTimeException: Invalid ID for region-based ZoneId: Invalid/Zone

• Неверный формат даты: при разборе строки без указания смещения и зоны.

  ZonedDateTime.parse("2024-12-01T10:15:30");

  DateTimeParseException: Text '2024-12-01T10:15:30' could not be parsed: ...

  В строке должен быть либо +/– и зона, либо только зона.
• Null аргумент: передача null в параметры статических методов приводит к NullPointerException.
• Неоднозначное время при DST: если время выпадает на переход (например, 2:30 в день перевода стрелок), ZonedDateTime автоматически выбирает смещение до или после перехода по правилам зоны; это может привести к неожиданному смещению.

Изменения в последних версиях

Класс ZonedDateTime был добавлен в Java 8 (март 2014) и с тех пор не претерпел существенных изменений. В Java 9 были незначительно улучшены некоторые методы (например, добавлены перегрузки с Clock в классе ZonedDateTime, но они уже были в Java 8). Основное развитие касается обновления базы данных временных зон (tzdata), которая поставляется вместе с JDK и регулярно обновляется. В Java 17 и более поздних версиях поддержка зон доведена до актуального состояния (например, отказ от некоторых исторических зон).

Расширенные примеры

Работа с переходом на летнее время

import java.time.*;

ZoneId ny = ZoneId.of("America/New_York");
// Время до перехода: 2024-03-10 01:30 (EST -05:00)
ZonedDateTime beforeDst = ZonedDateTime.of(2024, 3, 10, 1, 30, 0, 0, ny);
System.out.println("До перехода: " + beforeDst);
// Добавляем 1 час - получаем 3:30 EDT (переход произошел)
ZonedDateTime afterDst = beforeDst.plusHours(1);
System.out.println("Через 1 час: " + afterDst);

До перехода: 2024-03-10T01:30-05:00[America/New_York]
Через 1 час: 2024-03-10T03:30-04:00[America/New_York]

Преобразование с сохранением локального времени

ZoneId paris = ZoneId.of("Europe/Paris");
ZoneId tokyo = ZoneId.of("Asia/Tokyo");
ZonedDateTime inParis = ZonedDateTime.of(2024, 12, 1, 12, 0, 0, 0, paris);
ZonedDateTime sameLocalTokyo = inParis.withZoneSameLocal(tokyo);
ZonedDateTime sameInstantTokyo = inParis.withZoneSameInstant(tokyo);
System.out.println("Париж: " + inParis);
System.out.println("Тот же локальный в Токио: " + sameLocalTokyo);
System.out.println("Тот же момент в Токио: " + sameInstantTokyo);

Париж: 2024-12-01T12:00+01:00[Europe/Paris]
Тот же локальный в Токио: 2024-12-01T12:00+09:00[Asia/Tokyo] (момент другой)
Тот же момент в Токио: 2024-12-01T20:00+09:00[Asia/Tokyo]

Форматирование с DateTimeFormatter

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm z");
ZonedDateTime now = ZonedDateTime.now(ZoneId.of("Europe/Moscow"));
System.out.println(formatter.format(now));

01.12.2024 10:15 MSK

Разница во времени между двумя зонами

ZonedDateTime start = ZonedDateTime.of(2024, 12, 1, 8, 0, 0, 0, ZoneId.of("America/New_York"));
ZonedDateTime end = ZonedDateTime.of(2024, 12, 1, 20, 0, 0, 0, ZoneId.of("Asia/Tokyo"));
Duration duration = Duration.between(start, end);
System.out.println("Разница: " + duration.toHours() + " часов");

Разница: 5 часов

Обработка неоднозначного времени (DST)

// В зоне America/Sao_Paulo в 2024 переход произошел 20.02 в 00:00?
// (Для примера)
ZoneId sp = ZoneId.of("America/Sao_Paulo");
// Попытка создать время, которое не существует (2:30 в день перехода)
try {
    ZonedDateTime ambiguous = ZonedDateTime.of(2024, 2, 20, 2, 30, 0, 0, sp);
} catch (DateTimeException e) {
    System.out.println("Ошибка: " + e.getMessage());
}
// Используем withEarlierOffsetAtOverlap() и withLaterOffsetAtOverlap()
ZonedDateTime earlier = ambiguous.withEarlierOffsetAtOverlap();
ZonedDateTime later = ambiguous.withLaterOffsetAtOverlap();

В зависимости от правил зоны, может быть выброшено исключение или создан объект с одним из смещений. Рекомендуется проверять метод ZoneRules.getValidOffsets().