CKTIS / Java
LocalDate.of — créer une date à partir de l’année, du mois et du jour
Créez une date ISO à partir de trois champs, choisissez la surcharge adaptée et comparez les dates par valeur avec `equals`, pas par référence avec `==`.
Version : Java SE 21
Syntaxe
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)LocalDate.of est une méthode de fabrique statique de java.time.LocalDate. Elle reçoit l’année, le mois et le jour du mois dans cet ordre. Elle renvoie une date immuable du calendrier ISO-8601, sans heure ni fuseau horaire. Contrairement à LocalDate.now(), elle ne consulte pas l’horloge.
Le deuxième argument est soit un int de 1 (janvier) à 12 (décembre), soit une constante de l’énumération java.time.Month, par exemple Month.JANUARY. L’année doit être comprise entre -999999999 et 999999999, bornes incluses. Le jour doit être compris entre 1 et 31 et exister dans le mois et l’année indiqués. Une valeur hors limites ou une date inexistante comme le 29 février 2019 déclenche une DateTimeException ; la méthode ne corrige pas la date. Passer null comme Month déclenche une NullPointerException.
LocalDate est une classe fondée sur les valeurs. Deux appels pour 2020-01-01 donnent des dates égales selon equals, sans garantie d’obtenir deux objets distincts. == compare les références, pas les dates. N’utilisez pas les instances de LocalDate pour la synchronisation.
Exemples
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");
}
}
}Résultat
2020-01-01 2020-06-01 2020-07-01 2019-12-31 true DateTimeException
Le programme affiche des dates fixes en janvier, juin et juillet 2020, ainsi qu’une date en décembre de l’année précédente, calculée par `year - 1`. Les deux surcharges donnent la même date de janvier, donc `equals` renvoie `true`. Comme 2019 n’est pas bissextile, le bloc `catch` affiche `DateTimeException`.
Leçons associées
- Java · Leçon 4 · Avancé · Version : 2
- Java · Leçon 11 · Avancé · Version : 2