Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources