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

CKTIS / Java

Construire un LocalDateTime et trouver le lundi d’une semaine ISO

Construisez des dates et heures locales à partir de valeurs fixes, trouvez le lundi de la même semaine ISO et choisissez la surcharge qui renvoie le type voulu.

Version : Java SE 21

Syntaxe

Java SE 21 — java.time

Static factories:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
The same three component overloads accept Month instead of int for month.
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)

Instance methods on a LocalDate named date:
LocalDate date.with(TemporalAdjuster adjuster)
LocalDate date.with(TemporalField field, long newValue)
LocalDateTime date.atTime(int hour, int minute)
LocalDateTime date.atTime(int hour, int minute, int second)
LocalDateTime date.atTime(int hour, int minute, int second, int nanoOfSecond)
LocalDateTime date.atTime(LocalTime time)
OffsetDateTime date.atTime(OffsetTime time)

Common composition: date.with(DayOfWeek.MONDAY).atTime(9, 30)

Dans java.time, la méthode de fabrique statique LocalDate.of crée une date ISO à partir de l’année, du mois et du jour du mois. Le mois s’exprime par un nombre de 1 à 12 ou une valeur de Month comme Month.MARCH. La méthode de fabrique statique LocalDateTime.of prend les mêmes composants de date, plus l’heure et les minutes ; d’autres surcharges acceptent aussi les secondes, puis les nanosecondes. Les secondes et nanosecondes omises valent zéro. Une autre surcharge combine un LocalDate et un LocalTime existants.

La méthode d’instance LocalDate.with ne modifie pas la date d’origine : utilisez la valeur renvoyée. Dans date.with(DayOfWeek.MONDAY), la valeur d’énumération joue le rôle de TemporalAdjuster et choisit le lundi de la même semaine ISO (du lundi au dimanche), indépendamment des paramètres régionaux. Si la date est déjà un lundi, sa valeur reste identique ; sinon, le résultat est antérieur et peut tomber dans un autre mois ou une autre année. La surcharge with(TemporalField, long) attribue une valeur numérique à un champ. Pour ChronoField.DAY_OF_WEEK, 1 sélectionne aussi le lundi de la même semaine ISO.

La méthode d’instance LocalDate.atTime combine la date avec un LocalTime ou avec les composants de l’heure : heures et minutes, suivies éventuellement des secondes, puis des nanosecondes. Les composants omis valent zéro. Avec un LocalTime, date.atTime(time) donne la même valeur que LocalDateTime.of(date, time). La surcharge prenant un OffsetTime renvoie en revanche un OffsetDateTime et conserve le décalage par rapport à UTC.

Les méthodes of lèvent une DateTimeException si la date est invalide. Les surcharges qui prennent des composants horaires numériques lèvent cette exception si l’un sort de sa plage, par exemple pour une heure égale à 24. LocalDate et LocalDateTime sont immuables. Un LocalDateTime ne contient ni fuseau horaire ni décalage par rapport à UTC : il ne suffit donc pas à identifier un instant.

Exemples

import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Month;

public class Main {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, Month.MARCH, 1);
        LocalDate monday = date.with(DayOfWeek.MONDAY);

        LocalDateTime adjusted = monday.atTime(9, 30);
        LocalDateTime direct = LocalDateTime.of(2024, 2, 26, 9, 30);
        LocalDateTime combined = LocalDateTime.of(monday, LocalTime.of(9, 30));

        System.out.println(date);
        System.out.println(adjusted);
        System.out.println(adjusted.equals(direct) && adjusted.equals(combined));
    }
}

Résultat

2024-03-01
2024-02-26T09:30
true

L’entrée est le vendredi `2024-03-01`. Le lundi correspondant, `2024-02-26`, tombe le mois précédent. Avec l’heure `09:30`, les trois approches donnent des valeurs `LocalDateTime` égales, ce que confirme `true`.

Leçons associées

  • Java · Leçon 60 · Avancé · Version : 2

Sources