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

CKTIS / Java

LocalDate — une date sans heure ni fuseau horaire

LocalDate représente une date immuable du calendrier ISO, sans heure ni fuseau horaire. Il permet de créer, décaler, comparer, analyser et formater des dates.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)

java.time.LocalDate stocke une date du calendrier ISO sans heure ni fuseau horaire ; à lui seul, il ne désigne pas un instant sur la ligne du temps. Il est immuable et thread-safe. LocalDate.of(year, month, dayOfMonth) crée une date ; les mois sont numérotés de 1 à 12. Une date invalide provoque DateTimeException.

LocalDate.plusDays renvoie le résultat de l’ajout de jours, en tenant compte des limites des mois et des années bissextiles ; l’objet d’origine reste inchangé. LocalDate.with(adjuster) applique une règle d’ajustement, tandis que LocalDate.with(field, newValue) définit un champ. Le traitement d’un jour invalide dépend du champ : changer le mois peut ramener le jour au dernier jour du mois, mais un DAY_OF_MONTH invalide provoque une exception.

LocalDate.isAfter vérifie si une date est postérieure. LocalDate.equals compare les valeurs de dates de type LocalDate, et non l’identité des objets — ne le remplacez pas par ==. Pour deux objets LocalDate, LocalDate.compareTo renvoie un nombre négatif, zéro ou un nombre positif selon l’ordre des dates ; ne supposez pas que le résultat vaut exactement -1 ou 1.

LocalDate.parse(text) lit une date ISO ; la surcharge avec formateur prend en charge un autre format. Un échec d’analyse provoque DateTimeParseException. LocalDate.toString renvoie du texte ISO, tandis que LocalDate.format(formatter) utilise le formateur fourni. Dans le motif dd/MM/uuuu, uuuu désigne l’année, et non l’année de l’ère (yyyy).

LocalDate.atTime(hour, minute) crée un LocalDateTime, toujours sans fuseau horaire ; la surcharge avec OffsetTime renvoie un OffsetDateTime. L’exemple utilise des dates fixes et montre le 29 février 2024. Périmètre de la documentation : Java SE 21 ; l’environnement de production n’est pas attesté.

Exemples

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate next = start.plusDays(1);
        LocalDate parsed = LocalDate.parse("2024-02-29");
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");

        System.out.println(start.toString());
        System.out.println(next.toString());
        System.out.println(next.isAfter(start));
        System.out.println(next.equals(parsed));
        System.out.println(start.compareTo(next) < 0);
        System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
        System.out.println(next.atTime(9, 30));
        System.out.println(next.format(formatter));
    }
}

Résultat

2024-02-28
2024-02-29
true
true
true
2024-02-29
2024-02-29T09:30
29/02/2024

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources