Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

ZonedDateTime: stvaranje, pretvorbe, formatiranje i kalendarske izmjene

Stvori datum i vrijeme s vremenskom zonom, pretvori ih bez promjene trenutka, oblikuj ispis i izmijeni lokalna polja uz pravila pomicanja sata.

Verzija: Java SE 21

Sintaksa

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 pohranjuje lokalni datum i vrijeme, identifikator zone i utvrđeni pomak u odnosu na UTC. Statička metoda ZonedDateTime.of prima LocalDateTime, par LocalDate i LocalTime ili sedam cijelih brojeva (od year do nanoOfSecond), uvijek uz ZoneId. Ako lokalno vrijeme upadne u prazninu nastalu pomicanjem sata unaprijed, metoda ga pomiče unaprijed za trajanje praznine. Ako se lokalno vrijeme ponovi, odabire pomak koji odgovara ranijem trenutku. Nevaljana brojčana polja ili nepostojeći datum uzrokuju DateTimeException.

ZonedDateTime.ofInstant(Instant, ZoneId) određuje lokalni datum, vrijeme i pomak zadanog trenutka u ciljnoj zoni. Preopterećena inačica (LocalDateTime, ZoneOffset, ZoneId) najprije određuje trenutak iz zadanog lokalnog datuma, vremena i pomaka, a zatim ga prikazuje u ciljnoj zoni. Lokalno vrijeme i pomak mogu se razlikovati od ulaznih vrijednosti. Naslijeđena metoda ZonedDateTime.toInstant() vraća isti trenutak bez podataka o zoni. ZonedDateTime.withZoneSameInstant(ZoneId) zadržava trenutak, ali može promijeniti lokalni datum i vrijeme. Nasuprot tome, withZoneSameLocal pokušava zadržati lokalni datum i vrijeme te može promijeniti trenutak.

ZonedDateTime.format(DateTimeFormatter) vraća String bez izmjene objekta. ISO_OFFSET_DATE_TIME ispisuje lokalni datum, vrijeme i pomak, ali ne i identifikator regionalne zone. Ako formatiranje ne uspije, metoda baca DateTimeException.

ZonedDateTime.with(TemporalAdjuster) primjenjuje pravilo, primjerice TemporalAdjusters.lastDayOfMonth(). Preopterećena inačica with(TemporalField, long) postavlja podržano polje poput ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS postavlja sekundu na vremenskoj crti i zadržava zonu i dio sekunde. OFFSET_SECONDS može samo prijeći na drugi valjani pomak kada se lokalno vrijeme ponovi. Nepodržano polje može uzrokovati UnsupportedTemporalTypeException, a nevaljana vrijednost DateTimeException.

ZonedDateTime.withHour(int) postavlja sat (0–23), a ZonedDateTime.withMinute(int) minutu (0–59); nijedna metoda ne pribraja proteklo vrijeme. Vrijednost izvan raspona uzrokuje DateTimeException. Pri izmjeni lokalnih polja zona ostaje ista, ali trenutak se može promijeniti. U praznini se rezultat pomiče unaprijed za njezino trajanje. Kada se vrijeme ponovi, zadržava se prethodni pomak ako je valjan; inače se bira raniji trenutak. Objekti su nepromjenjivi, zato spremi vraćeni rezultat.

Primjeri

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));
    }
}

Rezultat

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

Prva tri retka prikazuju isti trenutak. `true` pokazuje da se obje pretvorbe u `-05:00` podudaraju. Posljednji redak prikazuje kalendarsku izmjenu na 29. veljače u 14:45 uz izvorni pomak. Fiksni pomaci čine primjer neovisnim o pravilima regionalnih vremenskih zona.

Povezane lekcije

  • Java · Lekcija 59 · Srednje · Verzija: 2

Izvori