Classe Java LocalDate

La classe Java LocalDate est immuable, ce qui signifie qu'une fois qu'une instance est créée, vous ne pouvez pas la modifier. LocalDate fournit de nombreuses méthodes utiles pour manipuler et interroger des dates, telles que l'ajout ou la soustraction de jours, de mois ou d'années, l'obtention du jour de la semaine ou la vérification si une date est antérieure ou postérieure à une autre date.

Exemple de date locale

Commençons par un exemple simple qui crée une instance LocalDate pour la date actuelle et l'imprime sur la console :

import java.time.LocalDate;

public class LocalDateExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("Today's date: " + today);
    }
}

Dans cet exemple, nous importons la classe LocalDate du package java.time et créons une nouvelle instance de LocalDate appelée aujourd'hui à l'aide de la méthode statique now() . Cette méthode renvoie un objet LocalDate représentant la date actuelle en fonction de l'horloge système dans le fuseau horaire par défaut. Nous imprimons ensuite la date actuelle sur la console en utilisant la méthode println() de l' objet System.out . Le résultat ressemblera à ceci :

Sortir

Constructeurs LocalDate

Outre la méthode now() , LocalDate fournit plusieurs autres constructeurs qui vous permettent de créer des instances LocalDate à partir de différentes sources. Par exemple, vous pouvez créer un LocalDate à partir d'une année, d'un mois et d'un jour spécifiques :

import java.time.LocalDate;

public class LocalDateConstructorExample {
    public static void main(String[] args) {
        LocalDate date1 = LocalDate.of(2023, 5, 1);

        System.out.println("Date 1: " + date1);
    }
}

Ce code crée une nouvelle instance LocalDate appelée date1 avec l'année 2023, le mois de mai (représenté par la valeur 5) et le jour 1. Le résultat sera :

Sortir

Manipulation de la date locale

L'une des fonctionnalités les plus utiles de LocalDate est la possibilité de manipuler les dates. Par exemple, vous pouvez ajouter ou soustraire des jours, des mois ou des années en utilisant les méthodes plus et moins :

import java.time.LocalDate;

public class LocalDateManipulationExample {
    public static void main(String[] args) {

        LocalDate date3 = LocalDate.parse("2023-05-01");
        LocalDate date4 = date3.plusDays(1);
        LocalDate date5 = date3.minusMonths(1);
        LocalDate date6 = date3.plusYears(1);

        System.out.println("Date 3: " + date3);
        System.out.println("Date 4: " + date4);
        System.out.println("Date 5: " + date5);
        System.out.println("Date 6: " + date6);
   }
}

Dans cet exemple, nous créons d'abord une nouvelle instance LocalDate appelée date3 en analysant la chaîne « 2023-05-01 ». Nous créons ensuite trois nouvelles instances LocalDate appelées date4 , date5 et date6 en ajoutant ou en soustrayant des jours, des mois ou des années à date3 . Le résultat sera :

Comparaison des dates locales

LocalDate fournit également des méthodes pour comparer les dates. Vous pouvez vérifier si deux instances LocalDate sont égales, ou si l'une est avant ou après l'autre en utilisant les méthodes equals() , isBefore() et isAfter() :

import java.time.LocalDate;

public class LocalDateCompareExample {
    public static void main(String[] args) {
        LocalDate date1 = LocalDate.parse("2023-05-01");
        LocalDate date2 = LocalDate.parse("2023-05-02");

        System.out.println("Are the dates equal? " + date1.equals(date2));
        System.out.println("Is date1 before date2? " + date1.isBefore(date2));
        System.out.println("Is date2 after date1? " + date2.isAfter(date1));
    }
}

Dans cet exemple, nous créons deux instances LocalDate appelées date1 et date2 , puis utilisons les méthodes equals() , isBefore() et isAfter() pour les comparer. La sortie sera sous forme booléenne, c'est-à-dire true ou false :

DateHeure Locale

Si vous devez représenter une date et une heure, vous pouvez utiliser la classe LocalDateTime , qui est similaire à LocalDate mais inclut un composant horaire. LocalDateTime fournit des méthodes pour manipuler et interroger à la fois les parties date et heure. Voici un exemple de création d'une instance LocalDateTime :

import java.time.LocalDateTime;

public class LocalDateTimeExample {
    public static void main(String[] args) {
        LocalDateTime datetime = LocalDateTime.now();
        System.out.println("Current date and time: " + datetime);
    }
}

Ce code importe la classe LocalDateTime et crée une nouvelle instance appelée datetime à l'aide de la méthode now() . Le résultat ressemblera à ceci : Remarque : « T » dans la sortie indique le début de l'horodatage.

Conclusion

La classe Java LocalDate est utile pour travailler avec des dates en Java. Il fournit de nombreuses méthodes pour manipuler et interroger les dates, ce qui facilite l'ajout ou la soustraction de jours, de mois ou d'années, la vérification si une date est avant ou après une autre date, et bien plus encore. Si vous devez travailler ensemble avec des dates et des heures, vous pouvez utiliser la classe LocalDateTime à la place. N'hésitez pas à expérimenter ce cours et à partager vos résultats avec nous ! Revenez à ce message chaque fois que vous vous sentez coincé. Bon codage !