Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

LocalDateTime — data e hora sem fuso horário

LocalDateTime armazena uma data e hora do calendário ISO sem fuso horário nem desvio UTC. Permite criar valores, adicionar horas e minutos e formatar o resultado sem alterar o valor original.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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 representa uma data e hora sem fuso horário nem desvio UTC. Por si só, não identifica um instante único na linha temporal. Não o utilize para calcular o tempo efetivamente decorrido durante uma mudança da hora de verão; para isso, é necessário o contexto de um fuso horário ou valores Instant.

LocalDateTime.of(year, month, dayOfMonth, hour, minute) cria um valor com os segundos e nanossegundos definidos como zero. Os meses são numerados de 1 a 12. Uma data inválida, como 30 de fevereiro, gera uma DateTimeException.

LocalDateTime.plusHours(long) e LocalDateTime.plusMinutes(long) devolvem um resultado sem alterar o original, pelo que deve guardar o resultado. Também aceitam valores negativos. Ao passar a meia-noite, a data é atualizada; exceder o intervalo suportado gera uma DateTimeException.

LocalDateTime.format(DateTimeFormatter) devolve uma String. No padrão uuuu-MM-dd HH:mm, MM significa mês, mm minutos e HH uma hora no formato de 24 horas. O exemplo utiliza dados de entrada fixos e Locale.ROOT, demonstrando a passagem para o ano seguinte e que start permanece inalterado.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes