Classe Java LocalDateTime

LocalDateTime est une classe importante de l'API date-heure introduite dans Java 8 (le package java.time). Elle représente un objet date-heure immuable sans informations de fuseau horaire. Cette classe peut stocker des informations de date-heure avec une précision à l'année, au mois, au jour, à l'heure, à la minute, à la seconde et à la nanoseconde.

Caractéristiques de LocalDateTime

  1. Immutabilité: Toutes les classes java.time sont immuables et thread-safe
  2. Aucune information de fuseau horaire: Représente uniquement la date et l'heure locales
  3. Précision à la nanoseconde: Peut représenter le temps avec une précision à la nanoseconde
  4. API riche: Fournit de nombreuses méthodes pour le calcul et le formatage de date-heure

Création d'objets LocalDateTime

1. Utilisation de méthodes de fabrique statiques

Exemple

// Obtenir la date-heure actuelle
LocalDateTime now = LocalDateTime.now();

// Créer en utilisant une date et une heure spécifiées
LocalDateTime specificDateTime = LocalDateTime.of(2023, 5, 15, 14, 30, 45);

// Utilisation de l'année, du mois, du jour, de l'heure, de la minute
LocalDateTime dateTime1 = LocalDateTime.of(2023, Month.MAY, 15, 14, 30);

// Utilisation de l'année, du mois, du jour, de l'heure, de la minute, de la seconde
LocalDateTime dateTime2 = LocalDateTime.of(2023, 5, 15, 14, 30, 45);

// Utilisation de l'année, du mois, du jour, de l'heure, de la minute, de la seconde, de la nanoseconde
LocalDateTime dateTime3 = LocalDateTime.of(2023, 5, 15, 14, 30, 45, 100);

2. Combinaison à partir de LocalDate et LocalTime

Exemple

LocalDate date = LocalDate.of(2023, 5, 15);
LocalTime time = LocalTime.of(14, 30, 45);
LocalDateTime dateTime = LocalDateTime.of(date, time);

3. Analyse de chaînes

Exemple

LocalDateTime parsedDateTime = LocalDateTime.parse("2023-05-15T14:30:45");

Méthodes d'opération courantes

Obtention des composants de date et d'heure

Exemple

LocalDateTime dateTime = LocalDateTime.now();

int year = dateTime.getYear();
Month month = dateTime.getMonth(); // Retourne l'énumération Month
int monthValue = dateTime.getMonthValue(); // Retourne 1-12
int day = dateTime.getDayOfMonth();
int hour = dateTime.getHour();
int minute = dateTime.getMinute();
int second = dateTime.getSecond();
int nano = dateTime.getNano();

Arithmétique date-heure

Exemple

LocalDateTime dateTime = LocalDateTime.now();

// Opérations d'addition
LocalDateTime plusYears = dateTime.plusYears(1);
LocalDateTime plusMonths = dateTime.plusMonths(1);
LocalDateTime plusDays = dateTime.plusDays(1);
LocalDateTime plusHours = dateTime.plusHours(1);
LocalDateTime plusMinutes = dateTime.plusMinutes(1);
LocalDateTime plusSeconds = dateTime.plusSeconds(1);

// Opérations de soustraction
LocalDateTime minusYears = dateTime.minusYears(1);
LocalDateTime minusDays = dateTime.minusDays(1);
// Les autres opérations de soustraction sont similaires...

Comparaison de date-heure

Exemple

LocalDateTime dateTime1 = LocalDateTime.of(2023, 5, 15, 14, 30);
LocalDateTime dateTime2 = LocalDateTime.of(2023, 5, 16, 14, 30);

boolean isBefore = dateTime1.isBefore(dateTime2); // true
boolean isAfter = dateTime1.isAfter(dateTime2); // false
boolean isEqual = dateTime1.isEqual(dateTime2); // false

Ajustement de la date et de l'heure

Exemple

LocalDateTime dateTime = LocalDateTime.now();

// Modifier des champs spécifiques
LocalDateTime withYear = dateTime.withYear(2024);
LocalDateTime withHour = dateTime.withHour(15);
// Les autres champs sont similaires...

// Utilisation de TemporalAdjusters
LocalDateTime firstDayOfMonth = dateTime.with(TemporalAdjusters.firstDayOfMonth());
LocalDateTime lastDayOfYear = dateTime.with(TemporalAdjusters.lastDayOfYear());

Formatage et analyse

Formatage de la date et de l'heure

Exemple

LocalDateTime dateTime = LocalDateTime.now();

// Utilisation d'un format prédéfini
DateTimeFormatter isoDateTime = DateTimeFormatter.ISO_DATE_TIME;
String formatted = dateTime.format(isoDateTime);

// Format personnalisé
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String customFormatted = dateTime.format(formatter);

Analyse d'une chaîne en date-heure

Exemple

String str = "2023-05-15 14:30:45";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
LocalDateTime parsedDateTime = LocalDateTime.parse(str, formatter);

Conversions avec d'autres classes de date-heure

Conversion en LocalDate et LocalTime

Exemple

LocalDateTime dateTime = LocalDateTime.now();

LocalDate date = dateTime.toLocalDate();
LocalTime time = dateTime.toLocalTime();

Conversion avec Instant et ZonedDateTime

Exemple

// Informations sur le fuseau horaire requises
ZoneId zone = ZoneId.systemDefault();

// Convertir LocalDateTime en ZonedDateTime
ZonedDateTime zonedDateTime = dateTime.atZone(zone);

// Convertir ZonedDateTime en LocalDateTime
LocalDateTime fromZoned = zonedDateTime.toLocalDateTime();

// Convertir LocalDateTime en Instant
Instant instant = zonedDateTime.toInstant();

// Convertir Instant en LocalDateTime
LocalDateTime fromInstant = LocalDateTime.ofInstant(instant, zone);

Exemples d’application pratique

Calcul de l'intervalle entre deux dates-heures

Exemple

LocalDateTime start = LocalDateTime.of(2023, 5, 15, 9, 0);
LocalDateTime end = LocalDateTime.of(2023, 5, 16, 17, 30);

Duration duration = Duration.between(start, end);

long hours = duration.toHours(); // 32
long minutes = duration.toMinutes(); // 1950

Vérifier si une date est comprise dans une plage spécifique

Exemple

LocalDateTime checkDate = LocalDateTime.of(2023, 5, 15, 14, 0);
LocalDateTime startDate = LocalDateTime.of(2023, 5, 1, 0, 0);
LocalDateTime endDate = LocalDateTime.of(2023, 5, 31, 23, 59);

boolean isInRange = !checkDate.isBefore(startDate) && !checkDate.isAfter(endDate);

Génération d'une séquence de date-heure

Exemple

LocalDateTime start = LocalDateTime.of(2023, 5, 1, 9, 0);
List<LocalDateTime> dateTimes = new ArrayList<>();

for (int i = 0; i < 10; i++) {
    dateTimes.add(start.plusDays(i));
}

Exemple complet

Exemple

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class LocalDateTimeDemo {
    public static void main(String[] args) {
        // 1. Obtenir la date-heure actuelle
        LocalDateTime now = LocalDateTime.now();
        System.out.println("Date-heure actuelle : " + now);
       
        // 2. Créer une date-heure spécifique
        LocalDateTime specificDateTime = LocalDateTime.of(2023, 5, 15, 10, 30, 45);
        System.out.println("Date-heure spécifique : " + specificDateTime);
       
        // 3. Analyser à partir d'une chaîne
        LocalDateTime parsedDateTime = LocalDateTime.parse("2023-05-15T10:30:45");
        System.out.println("Date-heure analysée : " + parsedDateTime);
       
        // 4. Formater la sortie
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss);
        String formattedDateTime = now.format(formatter);
        System.out.println("Date-heure formatée : " + formattedDateTime);
       
        // 5. Récupérer chaque composant
        System.out.println("Année : " + now.getYear());
        System.out.println("Mois : " + now.getMonthValue() + " (" + now.getMonth() + ")");
        System.out.println("Jour : " + now.getDayOfMonth());
        System.out.println("Heure : " + now.getHour());
        System.out.println("Minute : " + now.getMinute());
        System.out.println("Seconde : " + now.getSecond());
       
        // 6. Opérations sur les dates-heures
        LocalDateTime tomorrow = now.plusDays(1);
        System.out.println("Demain à la même heure : " + tomorrow);
       
        LocalDateTime lastWeek = now.minusWeeks(1);
        System.out.println("La semaine dernière à la même heure : " + lastWeek);
       
        // 7. Comparer les dates-heures
        System.out.println("Est-ce que maintenant est après l'heure spécifiée : " + now.isAfter(specificDateTime));
        System.out.println("Est-ce que maintenant est avant l'heure spécifiée : " + now.isBefore(specificDateTime));
    }
}

La sortie est :

格式化后的日期时间: 2025年05月01日 11:25:48
年: 2025
月: 5 (MAY)
日: 1
时: 11
分: 25
秒: 48
明天此时: 2025-05-02T11:25:48.651400
上周此时: 2025-04-24T11:25:48.651400
现在是否在特定时间之后: true
现在是否在特定时间之前: false

Conversion de date-heure

Exemple

import java.time.*;

public class DateTimeConversion {
    public static void main(String[] args) {
        // Convertir LocalDateTime en LocalDate et LocalTime
        LocalDateTime dateTime = LocalDateTime.now();
        LocalDate date = dateTime.toLocalDate();
        LocalTime time = dateTime.toLocalTime();
       
        System.out.println("Partie date : " + date);
        System.out.println("Partie heure : " + time);
       
        // Créer LocalDateTime à partir de LocalDate et LocalTime
        LocalDateTime combined = LocalDateTime.of(date, time);
        System.out.println("Date-heure combinée : " + combined);
       
        // Convertir avec Instant (nécessite un fuseau horaire)
        ZoneId zone = ZoneId.of("Asia/Shanghai");
        Instant instant = dateTime.atZone(zone).toInstant();
        System.out.println("Converti en Instant : " + instant);
    }
}

La sortie est :

日期部分: 2025-05-01
时间部分: 11:27:02.724101
组合后的日期时间: 2025-05-01T11:27:02.724101
转换为Instant: 2025-05-01T03:27:02.724101Z

Résumé

La classe LocalDateTime est une classe très pratique dans l'API date-heure de Java 8. Elle fournit de riches méthodes pour gérer les dates et les heures sans fuseau horaire. Grâce à cet article, vous devriez avoir maîtrisé :

  1. Comment créer des objets LocalDateTime
  2. Comment effectuer des calculs et des comparaisons de date-heure
  3. Comment formater et analyser une date-heure
  4. Comment convertir avec d'autres classes de date-heure
  5. Quelques scénarios d'application pratiques

LocalDateTime est très adapté aux scénarios métier qui ne nécessitent pas d'informations de fuseau horaire, tels que les anniversaires et les heures de réunion. Pour les scénarios nécessitant une gestion de fuseau horaire, envisagez d'utiliser la classe ZonedDateTime.

Méthodes de fabrique statiques

Méthode Description Exemple
static LocalDateTime now() Obtenir la date-heure actuelle LocalDateTime.now()
static LocalDateTime of(int year, int month, int day, int hour, int minute) Créer avec l'année, le mois, le jour, l'heure et la minute spécifiés LocalDateTime.of(2023, 6, 15, 14, 30)
static LocalDateTime of(int year, int month, int day, int hour, int minute, int second) Créer avec l'année, le mois, le jour, l'heure, la minute et la seconde spécifiés LocalDateTime.of(2023, 6, 15, 14, 30, 45)
static LocalDateTime of(int year, Month month, int day, int hour, int minute) Créer en utilisant l'énumération Month LocalDateTime.of(2023, Month.JUNE, 15, 14, 30)
static LocalDateTime of(LocalDate date, LocalTime time) Créer en combinant LocalDate et LocalTime LocalDateTime.of(LocalDate.now(), LocalTime.now())
static LocalDateTime parse(CharSequence text) Analyser à partir d'une chaîne (format ISO) LocalDateTime.parse("2023-06-15T14:30:45")
static LocalDateTime parse(CharSequence text, DateTimeFormatter formatter) Analyser en utilisant un format spécifié LocalDateTime.parse("15/06/2023 14:30", DateTimeFormatter.ofPattern("dd/MM/yyyy HH:mm"))

Obtenir des informations sur la date et l'heure

Méthode Description Exemple
int getYear() Obtenir l'année 2023
Month getMonth() Obtenir le mois (énumération Month) Month.JUNE
int getMonthValue() Obtenir la valeur du mois (1-12) 6
int getDayOfMonth() Obtenir le jour du mois 15
int getDayOfYear() Obtenir le jour de l'année 166
DayOfWeek getDayOfWeek() Obtenir le jour de la semaine (énumération DayOfWeek) DayOfWeek.THURSDAY
int getHour() Obtenir l'heure (0-23) 14
int getMinute() Obtenir la minute (0-59) 30
int getSecond() Obtenir la seconde (0-59) 45
int getNano() Obtenir la nanoseconde 0

Opérations date-heure

Méthode Description Exemple
LocalDateTime plusDays(long days) Ajouter des jours dt.plusDays(5)
LocalDateTime plusHours(long hours) Ajouter des heures dt.plusHours(2)
LocalDateTime plusMinutes(long minutes) Ajouter des minutes dt.plusMinutes(30)
LocalDateTime plusSeconds(long seconds) Ajouter des secondes dt.plusSeconds(45)
LocalDateTime plusNanos(long nanos) Ajouter des nanosecondes dt.plusNanos(1000000)
LocalDateTime minusDays(long days) Soustraire des jours dt.minusDays(5)
LocalDateTime minusHours(long hours) Soustraire des heures dt.minusHours(2)
LocalDateTime minusMinutes(long minutes) Soustraire des minutes dt.minusMinutes(30)
LocalDateTime minusSeconds(long seconds) Soustraire des secondes dt.minusSeconds(45)
LocalDateTime minusNanos(long nanos) Soustraire des nanosecondes dt.minusNanos(1000000)
LocalDateTime withYear(int year) Modifier l'année dt.withYear(2024)
LocalDateTime withMonth(int month) Modifier le mois dt.withMonth(12)
LocalDateTime withDayOfMonth(int day) Modifier le jour du mois dt.withDayOfMonth(1)
LocalDateTime withHour(int hour) Modifier l'heure dt.withHour(0)
LocalDateTime withMinute(int minute) Modifier la minute dt.withMinute(0)
LocalDateTime withSecond(int second) Modifier la seconde dt.withSecond(0)
LocalDateTime withNano(int nano) Modifier la nanoseconde dt.withNano(0)

Comparaison de date-heure

Méthode Description Exemple
boolean isAfter(ChronoLocalDateTime<?> other) Indique s'il est postérieur à la date-heure spécifiée dt1.isAfter(dt2)
boolean isBefore(ChronoLocalDateTime<?> other) Indique s'il est antérieur à la date-heure spécifiée dt1.isBefore(dt2)
boolean isEqual(ChronoLocalDateTime<?> other) Indique s'il est égal à la date-heure spécifiée dt1.isEqual(dt2)
int compareTo(ChronoLocalDateTime<?> other) Comparer deux date-heures dt1.compareTo(dt2)

Méthodes de conversion

Méthode Description Exemple
LocalDate toLocalDate() Convertir en LocalDate dt.toLocalDate()
LocalTime toLocalTime() Convertir en LocalTime dt.toLocalTime()
Instant toInstant(ZoneOffset offset) Convertir en Instant dt.toInstant(ZoneOffset.UTC)
ZonedDateTime atZone(ZoneId zone) Convertir en ZonedDateTime dt.atZone(ZoneId.of("Asia/Shanghai"))
OffsetDateTime atOffset(ZoneOffset offset) Convertir en OffsetDateTime dt.atOffset(ZoneOffset.ofHours(8))

Formatage et conversion en chaîne

Méthode Description Exemple
String format(DateTimeFormatter formatter) Formater en chaîne dt.format(DateTimeFormatter.ISO_DATE_TIME)
String toString() Convertir en chaîne au format ISO "2023-06-15T14:30:45"
Autres extensions