Méthode withYear de Java LocalDate

Introduction

La méthode withYear() de la classe Java LocalDate est utilisée pour obtenir une nouvelle date avec l'année spécifiée. Elle renvoie une copie de l'instance LocalDate actuelle avec l'année modifiée à la valeur spécifiée. Ce laboratoire vous guidera étape par étape dans l'utilisation de la méthode withYear().

Skills Graph

Créez un fichier Java

Ouvrez le terminal et créez un fichier Java avec la commande touch.

touch ~/projet/WithYearExample.java

Cela crée un fichier Java nommé WithYearExample.java dans le répertoire ~/projet/.

Importez les packages nécessaires

Un package est un espace de noms qui organise un ensemble de classes et d'interfaces apparentées. Pour utiliser la classe LocalDate, nous devons importer le package java.time.LocalDate. Ajoutez le code suivant au fichier WithYearExample.java.

import java.time.LocalDate;

Créez une instance de LocalDate

Dans cette étape, nous allons créer une instance de la classe LocalDate à l'aide de la méthode of(). La méthode of() prend trois arguments : l'année, le mois et le jour. Ajoutez le code suivant après l'instruction d'importation.

LocalDate date = LocalDate.of(2022, 1, 15);
System.out.println("Date initiale : " + date);

Ici, nous définissons la date comme le 15 janvier 2022.

Changez l'année à l'aide de withYear()

Dans cette étape, nous allons utiliser la méthode withYear() pour modifier l'année de l'instance LocalDate. Ajoutez le code suivant après l'étape 3.

LocalDate newDate = date.withYear(2030);  // Définissez l'année sur 2030
System.out.println("Nouvelle date : " + newDate);

Ici, nous créons une nouvelle variable newDate et définissons l'année sur 2030 à l'aide de la méthode withYear().

Gérer un jour du mois invalide

Si l'instance LocalDate actuelle a un jour du mois qui est invalide pour la nouvelle année, alors la méthode withYear() ajuste la valeur du jour du mois au dernier jour valide du mois. Ajoutez le code suivant après l'étape 4.

LocalDate dateWithInvalidDayOfMonth = LocalDate.of(2021, 2, 31);
LocalDate newDateWithAdjustedDayOfMonth = dateWithInvalidDayOfMonth.withYear(2022);
System.out.println("Date ancienne : " + dateWithInvalidDayOfMonth + "\nNouvelle date : " + newDateWithAdjustedDayOfMonth);

Ici, nous définissons une date avec un jour du mois invalide, le 31 février 2021 qui n'existe pas. Nous appliquons ensuite la méthode withYear() pour changer l'année en 2022. Puisque 2022 n'est pas une année bissextile et que février n'a que 28 jours, le jour du mois est ajusté à 28, qui est le dernier jour valide de février.

Compilez et exécutez le programme

Pour compiler et exécuter le programme, accédez au répertoire du projet et exécutez la commande suivante.

javac WithYearExample.java && java WithYearExample

La sortie du programme après l'exécution de la commande ci-dessus devrait être la suivante :

Date initiale : 2022-01-15
Nouvelle date : 2030-01-15
Date ancienne : 2021-02-31
Nouvelle date : 2022-02-28

Récapitulatif

Dans ce laboratoire, nous avons appris à utiliser la méthode withYear() de la classe LocalDate en Java pour obtenir une date avec l'année spécifiée. Nous avons également appris à gérer un jour du mois invalide lorsqu'on utilise la méthode withYear(). En suivant ces étapes, vous devriez désormais être en mesure d'utiliser la méthode withYear() pour travailler efficacement avec des instances de LocalDate dans vos programmes Java.