CKTIS / Java
Créer et décaler une date-heure locale
Créez une date-heure locale avec `LocalDateTime.of`, puis ajoutez des heures ou des minutes sans modifier la valeur de départ.
Version : Java SE 21
Syntaxe
import java.time.LocalDateTime;
LocalDateTime start = LocalDateTime.of(year, month, dayOfMonth, hour, minute);
LocalDateTime later = start.plusHours(hours).plusMinutes(minutes);
// Factory arguments shown: int. Amounts passed to plusHours and plusMinutes: long.java.time.LocalDateTime associe une date du calendrier à une heure telle qu’elle s’affiche sur une horloge. Ce type ne stocke ni fuseau horaire ni décalage par rapport à UTC : à lui seul, il ne désigne pas un instant précis. Ses calculs ne tiennent pas compte des changements d’heure saisonniers.
Dans sa forme présentée ici, la méthode de fabrique statique LocalDateTime.of(year, month, dayOfMonth, hour, minute) prend cinq arguments de type int, dont un numéro de mois de 1 à 12. Elle fixe les champs des secondes et des nanosecondes à zéro. D’autres surcharges permettent de préciser les secondes et, éventuellement, les nanosecondes, d’utiliser une constante Month à la place du numéro de mois ou d’associer une LocalDate à une LocalTime. Dans les surcharges qui prennent des champs individuels, une date invalide ou un champ hors limites déclenche une DateTimeException.
Les méthodes d’instance plusHours(long hours) et plusMinutes(long minutes) ajoutent respectivement des heures et des minutes. Une valeur négative fait reculer la date-heure ; franchir minuit change aussi la date. Si le résultat sort de la plage de dates prise en charge, une DateTimeException est déclenchée.
LocalDateTime est immuable : les méthodes renvoient le résultat sans modifier l’objet sur lequel elles ont été appelées. Conservez la valeur renvoyée ou utilisez-la directement dans l’appel suivant, comme dans start.plusHours(1).plusMinutes(20).
Exemples
import java.time.LocalDateTime;
public class LocalDateTimeDemo {
public static void main(String[] args) {
LocalDateTime start = LocalDateTime.of(2026, 4, 30, 22, 50);
LocalDateTime afterHours = start.plusHours(1);
LocalDateTime afterMinutes = afterHours.plusMinutes(20);
System.out.println(start);
System.out.println(afterHours);
System.out.println(afterMinutes);
System.out.println(start);
}
}Résultat
2026-04-30T22:50 2026-04-30T23:50 2026-05-01T00:10 2026-04-30T22:50
Ajouter une heure donne 23:50 ; ajouter encore 20 minutes donne le 1er mai à 00:10. La dernière ligne répète la date-heure de départ. L’affichage sépare la date et l’heure par `T` et omet les champs des secondes et des nanosecondes, qui valent zéro.
Leçons associées
- Java · Leçon 68 · Débutant · Version : 2