CKTIS / Java
ZonedDateTime — dátum a čas s časovým pásmom
ZonedDateTime spája miestny dátum a čas, časové pásmo a vyriešený posun od UTC. Rozlišuje zmenu pásma pri zachovaní okamihu od zachovania miestneho času a rieši nejednoznačnosti spôsobené zmenami času.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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 nemenná a vláknovo bezpečná hodnota dátumu a času ISO s ZoneId a ZoneOffset. Regionálne pásmo určuje pravidlá pre zmeny posunu; pevný posun takéto zmeny nemá.
ZonedDateTime.of vytvorí hodnotu z miestneho dátumu a času a pásma. Pri medzere posunie čas dopredu o dĺžku medzery; pri prekrytí vyberie skorší posun. ZonedDateTime.ofLocal navyše prijíma preferovaný posun: použije ho, ak je platný, inak vyberie skorší posun; null znamená, že nie je zadaná žiadna preferencia. Medzery rieši rovnako. ZonedDateTime.ofInstant(instant, zone) zachová zadaný okamih bez tejto nejednoznačnosti.
ZonedDateTime.withZoneSameInstant zachová okamih a zvyčajne zmení miestny čas. ZonedDateTime.withZoneSameLocal podľa možností zachová miestny dátum a čas a uplatní pravidlá ofLocal; okamih sa môže zmeniť. ZonedDateTime.toInstant vráti iba okamih, bez identifikátora pásma, zatiaľ čo ZonedDateTime.format naformátuje hodnotu pomocou DateTimeFormatter.
ZonedDateTime.with(adjuster) použije TemporalAdjuster, zatiaľ čo ZonedDateTime.with(field, value) nastaví pole. ZonedDateTime.withHour nastaví hodinu na 0–23 a ZonedDateTime.withMinute minútu na 0–59. Zachovajte vrátenú hodnotu: pôvodná sa nezmení. Aj miestne zmeny hodiny alebo minúty sa riadia pravidlami pre medzery a prekrytia; neznamenajú pripočítanie uplynutého času.
Príklady
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()));
}
}Výsledok
2024-01-15T06:00:00-05:00 2024-01-15T12:00:00-05:00 true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.