CKTIS / Java
ZonedDateTime: vytváření, převody, formátování a změny kalendáře
Vytvářejte datum a čas s časovým pásmem, převádějte je bez změny okamžiku, formátujte výstup a upravujte místní pole s ohledem na změny času.
Verze: Java SE 21
Syntaxe
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ává místní datum a čas, identifikátor pásma a určený posun vůči UTC. Statická metoda ZonedDateTime.of přijímá LocalDateTime, dvojici LocalDate a LocalTime nebo sedm celých čísel (od year po nanoOfSecond), vždy společně s ZoneId. Pokud místní čas spadá do intervalu přeskočeného při posunu hodin vpřed, posune ho o délku tohoto intervalu dopředu. Pokud se místní čas opakuje, zvolí posun odpovídající dřívějšímu okamžiku. Neplatná číselná pole nebo neexistující datum vyvolají DateTimeException.
ZonedDateTime.ofInstant(Instant, ZoneId) určí pro zadaný okamžik místní datum, čas a posun v cílovém pásmu. Přetížení (LocalDateTime, ZoneOffset, ZoneId) nejprve odvodí okamžik ze zadaného místního data, času a posunu a potom ho vyjádří v cílovém pásmu. Místní čas i posun se mohou od vstupních hodnot lišit. Zděděná metoda ZonedDateTime.toInstant() vrací stejný okamžik bez informace o pásmu. ZonedDateTime.withZoneSameInstant(ZoneId) zachová okamžik, ale může změnit místní datum a čas. Naproti tomu withZoneSameLocal se snaží zachovat místní datum a čas a může změnit okamžik.
ZonedDateTime.format(DateTimeFormatter) vrací String, aniž změní objekt. ISO_OFFSET_DATE_TIME vypíše místní datum, čas a posun, ale ne identifikátor regionálního pásma. Při selhání formátování metoda vyvolá DateTimeException.
ZonedDateTime.with(TemporalAdjuster) použije pravidlo, například TemporalAdjusters.lastDayOfMonth(). Přetížení with(TemporalField, long) nastaví podporované pole, například ChronoField.MONTH_OF_YEAR. INSTANT_SECONDS nastaví sekundu na časové ose a zachová pásmo i zlomek sekundy. OFFSET_SECONDS umožňuje pouze přepnout na druhý platný posun při opakování místního času. Nepodporované pole může vyvolat UnsupportedTemporalTypeException, neplatná hodnota DateTimeException.
ZonedDateTime.withHour(int) nastaví hodinu (0–23) a ZonedDateTime.withMinute(int) minutu (0–59); ani jedna metoda nepřičítá dobu. Hodnoty mimo rozsah vyvolají DateTimeException. Při změně místních polí pásmo zůstává stejné, ale okamžik se může změnit. V přeskočeném intervalu se výsledek posune dopředu o jeho délku. Při opakování času zůstane dosavadní posun, je-li platný; jinak se zvolí dřívější okamžik. Objekty jsou neměnné, proto si uložte vrácený výsledek.
Pří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ýsledek
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
První tři řádky představují stejný okamžik. `true` ukazuje, že oba převody na `-05:00` souhlasí. Poslední řádek ukazuje změnu na 29. února ve 14:45 s původním posunem. Díky pevným posunům příklad nezávisí na pravidlech regionálních časových pásem.
Související lekce
- Java · Lekce 59 · Středně pokročilá · Verze: 2