Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

LocalDateTime — data e ora senza fuso orario

LocalDateTime memorizza una data e un’ora del calendario ISO senza fuso orario né offset UTC. Consente di creare valori, aggiungere ore e minuti e formattare il risultato senza modificare il valore originale.

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

Sintassi

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 rappresenta una data e un’ora senza fuso orario né offset UTC. Da solo non identifica un istante univoco sulla linea temporale. Non usarlo per calcolare il tempo effettivamente trascorso durante un cambio dell’ora legale; per farlo serve il contesto di un fuso orario oppure occorrono valori Instant.

LocalDateTime.of(year, month, dayOfMonth, hour, minute) crea un valore con secondi e nanosecondi impostati a zero. I mesi sono numerati da 1 a 12. Una data non valida, come il 30 febbraio, genera una DateTimeException.

LocalDateTime.plusHours(long) e LocalDateTime.plusMinutes(long) restituiscono un risultato senza modificare l’originale, quindi occorre conservare il risultato. Accettano anche quantità negative. Il passaggio oltre la mezzanotte aggiorna la data; superare l’intervallo supportato genera una DateTimeException.

LocalDateTime.format(DateTimeFormatter) restituisce una String. Nel pattern uuuu-MM-dd HH:mm, MM indica il mese, mm i minuti e HH l’ora nel formato a 24 ore. L’esempio usa dati di input fissi e Locale.ROOT, mostrando il passaggio all’anno successivo e il fatto che start rimane invariato.

Esempi

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));
    }
}

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti