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

CKTIS / Java

Analyser, créer et formater des dates et des dates-heures en Java

Construisez une date à partir de ses champs, lisez du texte ISO ou personnalisé et formatez une date ou une date-heure sans lui attribuer de fuseau horaire.

Version : Java SE 21

Syntaxe

Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter

Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.

Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTime

Dans java.time, LocalDate représente une date ISO seule, tandis que LocalDateTime associe une date ISO à une heure locale. Aucun des deux types ne stocke de fuseau horaire ni de décalage par rapport à UTC, et aucun ne désigne à lui seul un instant unique. Les deux types sont immuables.

LocalDate.of(year, month, dayOfMonth) est une fabrique statique qui accepte un mois numérique de 1 à 12 ou une constante Month. La fabrique statique LocalDateTime.of(date, time) associe un LocalDate à un LocalTime. Les surcharges par champs acceptent un mois numérique ou un Month, exigent l’heure et la minute et permettent d’ajouter la seconde, puis la nanoseconde. Une seconde ou une nanoseconde omise vaut zéro. Des champs invalides, comme le 29 février d’une année non bissextile, déclenchent une DateTimeException.

La méthode statique LocalDate.parse(text) utilise DateTimeFormatter.ISO_LOCAL_DATE, par exemple pour 2024-02-29. La surcharge LocalDate.parse(text, formatter) utilise le formateur fourni, par exemple avec le motif dd/MM/uuuu. Un texte qui ne peut pas être interprété comme une date déclenche une DateTimeParseException. Par défaut, DateTimeFormatter.ofPattern utilise SMART, qui peut ramener 29/02/2023 au 28 février. Pour rejeter ces dates, choisissez ResolverStyle.STRICT et utilisez uuuu (année) plutôt que yyyy (année dans l’ère).

Les méthodes d’instance LocalDate.format(formatter) et LocalDateTime.format(formatter) renvoient un String à l’aide du formateur fourni, sans modifier la valeur. Si un champ requis manque, par exemple l’heure demandée par HH:mm sur un LocalDate, le formatage déclenche une DateTimeException. LocalDate.toString() ne prend pas de formateur et renvoie du texte ISO-8601, par exemple 2024-02-29. La casse compte : MM désigne le mois, mm la minute et HH l’heure sur 24 heures.

Exemples

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        DateTimeFormatter dateFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);
        DateTimeFormatter dateTimeFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);

        LocalDate date = LocalDate.of(2024, 2, 29);
        LocalDate fromIso = LocalDate.parse("2024-02-29");
        LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);

        System.out.println(date.equals(fromIso) && date.equals(fromCustom));
        System.out.println(date.toString());
        System.out.println(date.format(dateFormat));

        LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
        System.out.println(dateTime.format(dateTimeFormat));

        try {
            LocalDate.parse("29/02/2023", dateFormat);
            System.out.println("Unexpected success");
        } catch (DateTimeParseException e) {
            System.out.println("Invalid date rejected");
        }
    }
}

Résultat

true
2024-02-29
29/02/2024
29/02/2024 09:05
Invalid date rejected

La première ligne confirme que les deux valeurs lues sont égales à la date créée par la fabrique. Les trois suivantes montrent la date ISO, la date au format personnalisé et la date-heure. La dernière montre que l’analyse stricte rejette le 29 février 2023.

Leçons associées

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

Sources