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

CKTIS / Java

ZonedDateTime: създаване, преобразуване, форматиране и календарни промени

Създавай дата и час с часова зона, преобразувай ги, без да сменяш момента, форматирай ги и променяй локалните полета според правилата на зоната.

Версия: Java SE 21

Синтаксис

java.time.ZonedDateTime — Java SE 21
static ZonedDateTime of(LocalDateTime dateTime, ZoneId zone)
static ZonedDateTime of(LocalDate date, LocalTime time, ZoneId zone)
static ZonedDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneId zone)
static ZonedDateTime ofInstant(Instant instant, ZoneId zone)
static ZonedDateTime ofInstant(LocalDateTime dateTime, ZoneOffset offset, ZoneId zone)
Instant toInstant() // inherited from ChronoZonedDateTime
ZonedDateTime withZoneSameInstant(ZoneId zone)
String format(DateTimeFormatter formatter)
ZonedDateTime with(TemporalAdjuster adjuster)
ZonedDateTime with(TemporalField field, long newValue)
ZonedDateTime withHour(int hour)
ZonedDateTime withMinute(int minute)

java.time.ZonedDateTime съхранява местни дата и час, идентификатор на часова зона и определеното отместване спрямо UTC. Статичният метод ZonedDateTime.of приема LocalDateTime, двойка LocalDate и LocalTime или седем цели числа (от year до nanoOfSecond), винаги със ZoneId. Ако местният час попада в интервал, прескочен при преместване на часовника напред, методът го измества напред с дължината на интервала. Ако местният час се повтаря, избира отместването, което съответства на по-ранния момент. Невалидни числови полета или несъществуваща дата предизвикват DateTimeException.

ZonedDateTime.ofInstant(Instant, ZoneId) определя местните дата и час и отместването за дадения момент в целевата зона. Претовареният вариант (LocalDateTime, ZoneOffset, ZoneId) първо определя момента от подадените местни дата и час и отместване, след което го представя в целевата зона. И местният час, и отместването могат да се различават от входните стойности. Наследеният метод ZonedDateTime.toInstant() връща същия момент без информация за зоната. ZonedDateTime.withZoneSameInstant(ZoneId) запазва момента, но може да промени местните дата и час. Обратно, withZoneSameLocal се опитва да запази местните дата и час и може да промени момента.

ZonedDateTime.format(DateTimeFormatter) връща String, без да променя обекта. ISO_OFFSET_DATE_TIME извежда местните дата и час и отместването, но не и идентификатора на регионалната зона. Ако форматирането не успее, методът хвърля DateTimeException.

ZonedDateTime.with(TemporalAdjuster) прилага правило, например TemporalAdjusters.lastDayOfMonth(). Претовареният вариант with(TemporalField, long) задава поддържано поле, например ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS задава секундата по времевата ос, като запазва зоната и дробната част от секундата. OFFSET_SECONDS може само да превключи към другото валидно отместване, когато местният час се повтаря. Неподдържано поле може да предизвика UnsupportedTemporalTypeException, а невалидна стойност — DateTimeException.

ZonedDateTime.withHour(int) задава часа (0–23), а ZonedDateTime.withMinute(int) — минутата (0–59); нито един от двата метода не добавя изминало време. Стойност извън диапазона предизвиква DateTimeException. При промяна на местните полета зоната остава същата, но моментът може да се промени. При прескочен интервал резултатът се измества напред с дължината му. При повторение на часа предишното отместване се запазва, ако е валидно; иначе се избира по-ранният момент. Обектите са неизменяеми, затова запази върнатия резултат.

Примери

import java.time.Instant;
import java.time.LocalDateTime;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.time.format.DateTimeFormatter;
import java.time.temporal.ChronoField;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        ZoneOffset east = ZoneOffset.of("+01:00");
        ZoneOffset west = ZoneOffset.of("-05:00");
        DateTimeFormatter iso = DateTimeFormatter.ISO_OFFSET_DATE_TIME;

        ZonedDateTime original = ZonedDateTime.of(
                LocalDateTime.of(2024, 1, 15, 10, 30), east);
        Instant instant = original.toInstant();
        ZonedDateTime converted = original.withZoneSameInstant(west);
        ZonedDateTime rebuilt = ZonedDateTime.ofInstant(instant, west);
        ZonedDateTime edited = original.with(ChronoField.MONTH_OF_YEAR, 2)
                .with(TemporalAdjusters.lastDayOfMonth())
                .withHour(14)
                .withMinute(45);

        System.out.println(original.format(iso));
        System.out.println(instant);
        System.out.println(converted.format(iso));
        System.out.println(converted.equals(rebuilt));
        System.out.println(edited.format(iso));
    }
}

Резултат

2024-01-15T10:30:00+01:00
2024-01-15T09:30:00Z
2024-01-15T04:30:00-05:00
true
2024-02-29T14:45:00+01:00

Първите три реда представят един и същ момент. `true` показва, че двете преобразувания към `-05:00` съвпадат. Последният ред показва календарната промяна към 29 февруари в 14:45 с първоначалното отместване. Фиксираните отмествания правят примера независим от правилата на регионалните часови зони.

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

  • Java · Урок 59 · Средно · Версия: 2

Източници