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