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

CKTIS / Java

LocalDate.of — criar uma data a partir do ano, do mês e do dia

Cria uma data ISO a partir de três campos, escolhe a sobrecarga adequada e compara datas pelo valor com `equals`, não pela referência com `==`.

Versão: Java SE 21

Sintaxe

public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)

LocalDate.of é um método de fábrica estático de java.time.LocalDate. Recebe o ano, o mês e o dia do mês, por esta ordem. Devolve uma data imutável do calendário ISO-8601, sem hora nem fuso horário. Ao contrário de LocalDate.now(), não consulta o relógio.

O segundo argumento é um int de 1 (janeiro) a 12 (dezembro) ou uma constante da enumeração java.time.Month, como Month.JANUARY. O ano tem de estar entre -999999999 e 999999999, inclusive. O dia tem de estar entre 1 e 31 e existir no mês e ano indicados. Um campo fora do intervalo ou uma data inexistente, como 29 de fevereiro de 2019, lança uma DateTimeException; o método não corrige a data. Passar null como Month lança uma NullPointerException.

LocalDate é uma classe baseada em valores. Duas chamadas para 2020-01-01 devolvem datas iguais segundo equals, mas não há garantia de que os objetos sejam distintos. == compara referências, não datas. Não uses instâncias de LocalDate para sincronização.

Exemplos

import java.time.DateTimeException;
import java.time.LocalDate;
import java.time.Month;

public class Main {
    public static void main(String[] args) {
        final int year = 2020;
        LocalDate january = LocalDate.of(year, 1, 1);
        LocalDate sameJanuary = LocalDate.of(year, Month.JANUARY, 1);
        LocalDate june = LocalDate.of(year, Month.JUNE, 1);
        LocalDate july = LocalDate.of(year, 7, 1);
        LocalDate previousDecember = LocalDate.of(year - 1, Month.DECEMBER, 31);

        System.out.println(january);
        System.out.println(june);
        System.out.println(july);
        System.out.println(previousDecember);
        System.out.println(january.equals(sameJanuary));

        try {
            LocalDate.of(year - 1, Month.FEBRUARY, 29);
        } catch (DateTimeException e) {
            System.out.println("DateTimeException");
        }
    }
}

Resultado

2020-01-01
2020-06-01
2020-07-01
2019-12-31
true
DateTimeException

O programa apresenta datas fixas de janeiro, junho e julho de 2020 e uma data de dezembro do ano anterior, calculado com `year - 1`. As duas sobrecargas produzem a mesma data de janeiro, pelo que `equals` devolve `true`. Como 2019 não é bissexto, o bloco `catch` apresenta `DateTimeException`.

Lições relacionadas

  • Java · Lição 4 · Avançado · Versão: 2
  • Java · Lição 11 · Avançado · Versão: 2

Fontes