CKTIS / Java
ZonedDateTime — datum a čas s časovým pásmem
ZonedDateTime spojuje místní datum a čas, časové pásmo a vyřešený posun od UTC. Rozlišuje změnu pásma při zachování okamžiku od zachování místního času a řeší nejednoznačnosti způsobené změnami času.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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 neměnná a vláknově bezpečná hodnota data a času ISO s ZoneId a ZoneOffset. Regionální pásmo určuje pravidla pro změny posunu; pevný posun takové změny nemá.
ZonedDateTime.of vytvoří hodnotu z místního data a času a pásma. Při mezeře posune čas dopředu o délku mezery; při překryvu zvolí dřívější posun. ZonedDateTime.ofLocal navíc přijímá preferovaný posun: použije ho, pokud je platný, jinak zvolí dřívější posun; null znamená, že není zadána žádná preference. Mezery řeší stejně. ZonedDateTime.ofInstant(instant, zone) zachová zadaný okamžik bez této nejednoznačnosti.
ZonedDateTime.withZoneSameInstant zachová okamžik a obvykle změní místní čas. ZonedDateTime.withZoneSameLocal pokud možno zachová místní datum a čas a použije pravidla ofLocal; okamžik se může změnit. ZonedDateTime.toInstant vrátí pouze okamžik, bez identifikátoru pásma, zatímco ZonedDateTime.format naformátuje hodnotu pomocí DateTimeFormatter.
ZonedDateTime.with(adjuster) použije TemporalAdjuster, zatímco ZonedDateTime.with(field, value) nastaví pole. ZonedDateTime.withHour nastaví hodinu na 0–23 a ZonedDateTime.withMinute minutu na 0–59. Uchovejte vrácenou hodnotu: původní se nezmění. I místní změny hodiny nebo minuty se řídí pravidly pro mezery a překryvy; neznamenají přičtení uplynulé doby.
Pří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ýsledek
2024-01-15T06:00:00-05:00 2024-01-15T12:00:00-05:00 true false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.