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

CKTIS / Java

LocalDate : créer, décaler, comparer et afficher des dates

Créez une date ISO, décalez-la de plusieurs jours calendaires sans modifier l’original, comparez-la à une autre date et obtenez sa représentation textuelle.

Version : Java SE 21

Syntaxe

import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;

// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()

java.time.LocalDate représente une date du calendrier ISO, sans heure ni fuseau horaire. La fabrique statique LocalDate.of prend dans l’ordre l’année, le mois et le jour du mois. Le mois peut être un int de 1 à 12 ou une valeur Month non null, comme Month.FEBRUARY. Une date invalide, par exemple le 29 février d’une année non bissextile, déclenche une DateTimeException au lieu d’être corrigée.

date.plusDays(n) prend un nombre de jours calendaires de type long et renvoie la date obtenue, en changeant de mois ou d’année si nécessaire. Une valeur négative fait reculer la date ; zéro conserve sa valeur. LocalDate est immuable : l’appel ne modifie pas date. Il faut donc conserver ou utiliser le résultat. Si le calcul ne déborde pas mais que la date obtenue sort de la plage prise en charge, la méthode déclenche une DateTimeException, comme avec LocalDate.MAX.plusDays(1). Dans le JDK 21, si l’addition au nombre de jours écoulés depuis l’époque dépasse les limites du type long, la méthode déclenche une ArithmeticException avant de vérifier la plage de dates.

a.isAfter(b) renvoie true uniquement si a est postérieure à b. Si a est antérieure ou que les deux dates désignent le même jour, le résultat est false. Le paramètre est de type ChronoLocalDate et b ne doit pas être null. La comparaison porte sur la position des dates sur l’axe temporel local, sans tenir compte de leur système calendaire.

date.toString() renvoie un String au format ISO-8601 uuuu-MM-dd, par exemple 2024-03-01. La méthode n’affiche rien et n’adapte pas le texte aux paramètres régionaux. Pour une présentation adaptée au lecteur, utilisez format avec un DateTimeFormatter approprié.

Exemples

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate later = start.plusDays(2);

        System.out.println(start.toString());
        System.out.println(later.toString());
        System.out.println(later.isAfter(start));
        System.out.println(later.isAfter(later));
    }
}

Résultat

2024-02-28
2024-03-01
true
false

2024 est une année bissextile : deux jours après `2024-02-28`, on arrive à `2024-03-01`. La première ligne montre que la date initiale est inchangée ; les deux dernières montrent que le résultat est postérieur à la date initiale, mais pas à lui-même.

Leçons associées

  • Java · Leçon 68 · Débutant · Version : 2

Sources