CKTIS / Java
LocalDate.of — een datum maken uit jaar, maand en dag
Maak een ISO-datum uit drie velden, kies de overload die bij je invoer past en vergelijk datums op waarde met `equals`, niet op referentie met `==`.
Versie: Java SE 21
Syntax
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)LocalDate.of is een statische fabrieksmethode van java.time.LocalDate. De methode krijgt het jaar, de maand en de dag van de maand, in die volgorde. Ze geeft een onveranderlijke datum in de ISO-8601-kalender terug, zonder tijdstip of tijdzone. Anders dan LocalDate.now() raadpleegt ze de klok niet.
Het tweede argument is een int van 1 (januari) tot en met 12 (december), of een constante uit de enum java.time.Month, zoals Month.JANUARY. Het jaar loopt van -999999999 tot en met 999999999. De dag moet van 1 tot en met 31 lopen en in de opgegeven maand en het jaar bestaan. Een veld buiten het bereik of een niet-bestaande datum zoals 29 februari 2019 leidt tot een DateTimeException; de methode past de datum niet aan. null doorgeven als Month leidt tot een NullPointerException.
LocalDate is een klasse die op waarden is gebaseerd. Twee aanroepen voor 2020-01-01 leveren datums op die volgens equals gelijk zijn, maar afzonderlijke objecten zijn niet gegarandeerd. == vergelijkt referenties, geen datums. Gebruik LocalDate-instanties niet voor synchronisatie.
Voorbeelden
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");
}
}
}Resultaat
2020-01-01 2020-06-01 2020-07-01 2019-12-31 true DateTimeException
Het programma toont vaste datums in januari, juni en juli 2020 en een datum in december van het voorafgaande jaar, berekend met `year - 1`. Beide overloads leveren dezelfde datum in januari op, dus `equals` geeft `true` terug. Omdat 2019 geen schrikkeljaar is, toont het `catch`-blok `DateTimeException`.
Gerelateerde lessen
- Java · Les 4 · Gevorderd · Versie: 2
- Java · Les 11 · Gevorderd · Versie: 2