CKTIS / Java
LocalDate — uma data sem hora nem fuso horário
LocalDate representa uma data imutável do calendário ISO, sem hora nem fuso horário. Permite criar, deslocar, comparar, analisar e formatar datas.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)java.time.LocalDate armazena uma data do calendário ISO sem hora nem fuso horário; por si só, não identifica um instante na linha temporal. É imutável e segura para utilização entre threads. LocalDate.of(year, month, dayOfMonth) cria uma data; os meses são numerados de 1 a 12. Uma data inválida causa DateTimeException.
LocalDate.plusDays devolve o resultado da adição de dias, tendo em conta os limites dos meses e os anos bissextos; o objeto original permanece inalterado. LocalDate.with(adjuster) aplica uma regra de ajuste, enquanto LocalDate.with(field, newValue) define um campo. O tratamento de um dia inválido depende do campo: alterar o mês pode limitar o dia ao fim do mês, mas um DAY_OF_MONTH inválido causa uma exceção.
LocalDate.isAfter verifica se uma data é posterior. LocalDate.equals compara valores de datas do tipo LocalDate, não a identidade dos objetos — não o substitua por ==. Para dois objetos LocalDate, LocalDate.compareTo devolve um número negativo, zero ou positivo, de acordo com a ordem das datas; não suponha que o resultado seja exatamente -1 ou 1.
LocalDate.parse(text) lê uma data ISO; a sobrecarga com formatter suporta outro formato. Um erro de análise causa DateTimeParseException. LocalDate.toString devolve texto ISO, enquanto LocalDate.format(formatter) utiliza o formatter fornecido. No padrão dd/MM/uuuu, uuuu significa ano, não ano da era (yyyy).
LocalDate.atTime(hour, minute) cria um LocalDateTime, ainda sem fuso horário; a sobrecarga com OffsetTime devolve OffsetDateTime. O exemplo utiliza datas fixas e demonstra 29 de fevereiro de 2024. Âmbito da documentação: Java SE 21; o ambiente de produção não está atestado.
Exemplos
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;
public class Main {
public static void main(String[] args) {
LocalDate start = LocalDate.of(2024, 2, 28);
LocalDate next = start.plusDays(1);
LocalDate parsed = LocalDate.parse("2024-02-29");
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");
System.out.println(start.toString());
System.out.println(next.toString());
System.out.println(next.isAfter(start));
System.out.println(next.equals(parsed));
System.out.println(start.compareTo(next) < 0);
System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
System.out.println(next.atTime(9, 30));
System.out.println(next.format(formatter));
}
}Resultado
2024-02-28 2024-02-29 true true true 2024-02-29 2024-02-29T09:30 29/02/2024
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.