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

CKTIS / Java

LocalDate: criar, deslocar, comparar e apresentar datas

Cria uma data do calendário ISO, desloca-a por dias de calendário sem alterar o original, compara-a com outra data e obtém a sua representação em texto.

Versão: Java SE 21

Sintaxe

import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;

// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()

java.time.LocalDate representa uma data do calendário ISO sem hora nem fuso horário. O método de fábrica estático LocalDate.of recebe, por esta ordem, o ano, o mês e o dia do mês. O mês pode ser um int de 1 a 12 ou um valor Month diferente de null, como Month.FEBRUARY. Uma data inválida, como 29 de fevereiro num ano não bissexto, lança uma DateTimeException em vez de ser corrigida.

date.plusDays(n) recebe um número de dias de calendário do tipo long e devolve a data resultante, mudando de mês ou de ano quando necessário. Um valor negativo recua a data; zero mantém o seu valor. LocalDate é imutável: a chamada não altera date, por isso guarda ou usa o valor devolvido. Se o cálculo não provocar um transbordo, mas a data resultante estiver fora do intervalo suportado, o método lança uma DateTimeException, como em LocalDate.MAX.plusDays(1). No JDK 21, se a soma intermédia ao número de dias desde a época exceder os limites do tipo long, o método lança uma ArithmeticException antes de verificar o intervalo de datas.

a.isAfter(b) devolve true apenas se a for posterior a b. Se a for anterior ou se ambas representarem o mesmo dia, devolve false. O parâmetro é do tipo ChronoLocalDate e b não pode ser null. A comparação usa a posição das datas no eixo temporal local, ignorando os respetivos sistemas de calendário.

date.toString() devolve uma String no formato ISO-8601 uuuu-MM-dd, por exemplo 2024-03-01. Não escreve nada na consola nem adapta o texto às definições regionais. Para um formato destinado ao leitor, usa format com um DateTimeFormatter adequado.

Exemplos

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate later = start.plusDays(2);

        System.out.println(start.toString());
        System.out.println(later.toString());
        System.out.println(later.isAfter(start));
        System.out.println(later.isAfter(later));
    }
}

Resultado

2024-02-28
2024-03-01
true
false

2024 é bissexto, pelo que dois dias depois de `2024-02-28` se chega a `2024-03-01`. A primeira linha mostra que a data inicial não mudou; as últimas duas mostram que o resultado é posterior à data inicial, mas não a si próprio.

Lições relacionadas

  • Java · Lição 68 · Básico · Versão: 2

Fontes