Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

ZonedDateTime — datum i vrijeme s vremenskom zonom

ZonedDateTime objedinjuje lokalni datum i vrijeme, vremensku zonu i razriješeni pomak od UTC-a. Razlikuje promjenu zone uz očuvanje trenutka od očuvanja lokalnog vremena te obrađuje nejasnoće uzrokovane promjenama sata.

Verzija: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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 je nepromjenjiva i sigurna za rad s više dretvi ISO vrijednost datuma i vremena s ZoneId i ZoneOffset. Regionalna zona određuje pravila za promjene pomaka; fiksni pomak nema takvih promjena.

ZonedDateTime.of stvara vrijednost iz lokalnog datuma i vremena te zone. U praznini pomiče vrijeme unaprijed za trajanje praznine; pri preklapanju odabire raniji pomak. ZonedDateTime.ofLocal prima i preferirani pomak: koristi ga ako je valjan, a inače odabire raniji pomak; null znači da nema preferencije. Praznine razrješava na isti način. ZonedDateTime.ofInstant(instant, zone) čuva zadani trenutak bez te nejasnoće.

ZonedDateTime.withZoneSameInstant čuva trenutak i obično mijenja lokalno vrijeme. ZonedDateTime.withZoneSameLocal čuva lokalni datum i vrijeme ako je moguće te primjenjuje pravila metode ofLocal; trenutak se može promijeniti. ZonedDateTime.toInstant vraća samo trenutak, bez identifikatora zone, dok ZonedDateTime.format oblikuje vrijednost pomoću DateTimeFormatter.

ZonedDateTime.with(adjuster) primjenjuje TemporalAdjuster, a ZonedDateTime.with(field, value) postavlja polje. ZonedDateTime.withHour postavlja sat na 0–23, a ZonedDateTime.withMinute minutu na 0–59. Sačuvajte vraćenu vrijednost: izvorna se ne mijenja. Lokalne promjene sata ili minute također slijede pravila za praznine i preklapanja; ne znače dodavanje proteklog trajanja.

Primjeri

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

Rezultat

2024-01-15T06:00:00-05:00
2024-01-15T12:00:00-05:00
true
false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori