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
- Immutabilité: Toutes les classes java.time sont immuables et thread-safe
- Aucune information de fuseau horaire: Représente uniquement la date et l'heure locales
- Précision à la nanoseconde: Peut représenter le temps avec une précision à la nanoseconde
- 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
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
LocalTime time = LocalTime.of(14, 30, 45);
LocalDateTime dateTime = LocalDateTime.of(date, time);
3. Analyse de chaînes
Exemple
Méthodes d'opération courantes
Obtention des composants de date et d'heure
Exemple
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
// 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 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
// 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
// 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
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
LocalDate date = dateTime.toLocalDate();
LocalTime time = dateTime.toLocalTime();
Conversion avec Instant et ZonedDateTime
Exemple
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 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 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
List<LocalDateTime> dateTimes = new ArrayList<>();
for (int i = 0; i < 10; i++) {
dateTimes.add(start.plusDays(i));
}
Exemple complet
Exemple
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
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é :
- Comment créer des objets LocalDateTime
- Comment effectuer des calculs et des comparaisons de date-heure
- Comment formater et analyser une date-heure
- Comment convertir avec d'autres classes de date-heure
- 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" |