Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

LocalDateTime — datum a čas bez časového pásma

LocalDateTime ukládá datum a čas podle kalendáře ISO bez časového pásma nebo posunu UTC. Umožňuje vytvářet hodnoty, přičítat hodiny a minuty a formátovat výsledek, aniž by se změnila původní hodnota.

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

Syntaxe

LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.plusHours(long hours)
LocalDateTime.plusMinutes(long minutes)
LocalDateTime.format(DateTimeFormatter formatter)

java.time.LocalDateTime představuje datum a čas bez časového pásma nebo posunu UTC. Samo o sobě neurčuje jedinečný okamžik na časové ose. Nepoužívejte ho k výpočtu skutečně uplynulého času přes změnu letního času; k tomu je potřeba kontext časového pásma nebo hodnoty Instant.

LocalDateTime.of(year, month, dayOfMonth, hour, minute) vytvoří hodnotu, ve které jsou sekundy a nanosekundy nastaveny na nulu. Měsíce jsou očíslovány od 1 do 12. Neplatné datum, například 30. února, vyvolá DateTimeException.

LocalDateTime.plusHours(long) a LocalDateTime.plusMinutes(long) vracejí výsledek, aniž by změnily původní hodnotu, takže si výsledek uložte. Přijímají také záporné hodnoty. Přechod přes půlnoc aktualizuje datum; překročení podporovaného rozsahu vyvolá DateTimeException.

LocalDateTime.format(DateTimeFormatter) vrací String. Ve vzoru uuuu-MM-dd HH:mm znamená MM měsíc, mm minuty a HH hodinu ve 24hodinovém formátu. Příklad používá pevné vstupy a Locale.ROOT; ukazuje přechod do následujícího roku i to, že start zůstává nezměněn.

Příklady

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        LocalDateTime start = LocalDateTime.of(2024, 12, 31, 23, 30);
        LocalDateTime end = start.plusHours(1).plusMinutes(45);
        DateTimeFormatter formatter =
                DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm", Locale.ROOT);

        System.out.println(start.format(formatter));
        System.out.println(end.format(formatter));
    }
}

Výsledek

2024-12-31 23:30
2025-01-01 01:15

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.

Zdroje