CKTIS / Java
Criar e deslocar uma data e hora locais
Cria uma data e hora locais com `LocalDateTime.of` e adiciona horas ou minutos sem alterar o valor original.
Versão: Java SE 21
Sintaxe
import java.time.LocalDateTime;
LocalDateTime start = LocalDateTime.of(year, month, dayOfMonth, hour, minute);
LocalDateTime later = start.plusHours(hours).plusMinutes(minutes);
// Factory arguments shown: int. Amounts passed to plusHours and plusMinutes: long.java.time.LocalDateTime combina uma data do calendário com uma hora tal como se lê num relógio. Não guarda um fuso horário nem um desvio em relação a UTC, pelo que não identifica, por si só, um instante. Os cálculos não têm em conta as mudanças da hora legal entre o verão e o inverno.
Na forma apresentada, o método de fábrica estático LocalDateTime.of(year, month, dayOfMonth, hour, minute) recebe cinco argumentos do tipo int, com o mês numerado de 1 a 12. Define os campos dos segundos e dos nanossegundos como zero. Outras sobrecargas permitem indicar os segundos e, opcionalmente, os nanossegundos, usar uma constante Month em vez do número do mês ou combinar um LocalDate com um LocalTime. Nas sobrecargas que recebem campos individuais, uma data inválida ou um campo fora do intervalo permitido provoca uma DateTimeException.
Os métodos de instância plusHours(long hours) e plusMinutes(long minutes) adicionam horas e minutos, respetivamente. Um valor negativo faz recuar a data e hora; ao passar pela meia-noite, a data também muda. Se o resultado ficar fora do intervalo de datas suportado, é lançada uma DateTimeException.
LocalDateTime é imutável: os métodos devolvem o resultado sem alterar o objeto em que foram chamados. Guarda o valor devolvido ou utiliza-o diretamente na chamada seguinte, como em start.plusHours(1).plusMinutes(20).
Exemplos
import java.time.LocalDateTime;
public class LocalDateTimeDemo {
public static void main(String[] args) {
LocalDateTime start = LocalDateTime.of(2026, 4, 30, 22, 50);
LocalDateTime afterHours = start.plusHours(1);
LocalDateTime afterMinutes = afterHours.plusMinutes(20);
System.out.println(start);
System.out.println(afterHours);
System.out.println(afterMinutes);
System.out.println(start);
}
}Resultado
2026-04-30T22:50 2026-04-30T23:50 2026-05-01T00:10 2026-04-30T22:50
Adicionar uma hora dá 23:50; adicionar mais 20 minutos dá 1 de maio às 00:10. A última linha repete a data e hora originais. O texto apresentado separa a data da hora com `T` e omite os campos dos segundos e dos nanossegundos porque valem zero.
Lições relacionadas
- Java · Lição 68 · Básico · Versão: 2