CKTIS / Java
ZonedDateTime: vytváranie, prevody, formátovanie a zmeny kalendára
Vytvárajte dátum a čas s časovým pásmom, prevádzajte ich bez zmeny okamihu, formátujte výstup a upravujte miestne polia s ohľadom na zmeny času.
Verzia: Java SE 21
Syntax
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 uchováva miestny dátum a čas, identifikátor pásma a určený posun voči UTC. Statická metóda ZonedDateTime.of prijíma LocalDateTime, dvojicu LocalDate a LocalTime alebo sedem celých čísel (od year po nanoOfSecond), vždy spolu s ZoneId. Ak miestny čas spadá do intervalu preskočeného pri posune hodín dopredu, posunie ho dopredu o dĺžku intervalu. Ak sa miestny čas opakuje, vyberie posun zodpovedajúci skoršiemu okamihu. Neplatné číselné polia alebo neexistujúci dátum vyvolajú DateTimeException.
ZonedDateTime.ofInstant(Instant, ZoneId) určí pre daný okamih miestny dátum, čas a posun v cieľovom pásme. Preťaženie (LocalDateTime, ZoneOffset, ZoneId) najprv odvodí okamih zo zadaného miestneho dátumu, času a posunu a potom ho vyjadrí v cieľovom pásme. Miestny čas aj posun sa môžu líšiť od vstupných hodnôt. Zdedená metóda ZonedDateTime.toInstant() vráti ten istý okamih bez informácie o pásme. ZonedDateTime.withZoneSameInstant(ZoneId) zachová okamih, ale môže zmeniť miestny dátum a čas. Naopak, withZoneSameLocal sa snaží zachovať miestny dátum a čas a môže zmeniť okamih.
ZonedDateTime.format(DateTimeFormatter) vráti String bez zmeny objektu. ISO_OFFSET_DATE_TIME vypíše miestny dátum, čas a posun, ale nie identifikátor regionálneho pásma. Pri zlyhaní formátovania metóda vyvolá DateTimeException.
ZonedDateTime.with(TemporalAdjuster) použije pravidlo, napríklad TemporalAdjusters.lastDayOfMonth(). Preťaženie with(TemporalField, long) nastaví podporované pole, napríklad ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS nastaví sekundu na časovej osi a zachová pásmo aj zlomok sekundy. OFFSET_SECONDS umožňuje iba prepnúť na druhý platný posun pri opakovaní miestneho času. Nepodporované pole môže vyvolať UnsupportedTemporalTypeException, neplatná hodnota DateTimeException.
ZonedDateTime.withHour(int) nastaví hodinu (0–23) a ZonedDateTime.withMinute(int) minútu (0–59); ani jedna metóda nepripočítava uplynutý čas. Hodnoty mimo rozsahu vyvolajú DateTimeException. Pri zmene miestnych polí sa pásmo nemení, no okamih sa môže zmeniť. V preskočenom intervale sa výsledok posunie dopredu o jeho dĺžku. Pri opakovaní času sa zachová doterajší posun, ak je platný; inak sa vyberie skorší okamih. Objekty sú nemenné, preto si uložte vrátený výsledok.
Príklady
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));
}
}Výsledok
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
Prvé tri riadky predstavujú ten istý okamih. `true` ukazuje, že oba prevody na `-05:00` sa zhodujú. Posledný riadok ukazuje zmenu na 29. februára o 14:45 s pôvodným posunom. Vďaka pevným posunom príklad nezávisí od pravidiel regionálnych časových pásiem.
Súvisiace lekcie
- Java · Lekcia 59 · Stredne pokročilá · Verzia: 2