Accueil / Date/Time / Duration et Period
Date/Time Débutant

Duration et Period

Calculez les différences de temps avec Duration et Period de façon sûre en termes de types.

Comparaison de Code
✕ Pre-Java 8 
// How many days between two dates?
long diff = date2.getTime()
    - date1.getTime();
long days = diff
    / (1000 * 60 * 60 * 24);
// ignores DST, leap seconds
✓ Java 8+ 
long days = ChronoUnit.DAYS
    .between(date1, date2);
Period period = Period.between(
    date1, date2);
Duration elapsed = Duration.between(
    time1, time2);
Un problème avec ce code ? Dites-le nous.
Pourquoi la méthode moderne gagne
🎯

Sûr en termes de types

Duration pour le temps, Period pour les dates — sans confusion.

🛡️

Calcul correct

Gère les transitions d'heure d'été, les années bissextiles et les secondes intercalaires.

📖

Lisible

ChronoUnit.DAYS.between() se lit comme un langage naturel.

Ancienne Approche
Arithmétique en millisecondes
Approche Moderne
Duration / Period
Depuis JDK
8
Difficulté
Débutant
Support JDK
Duration et Period
Disponible

Disponible depuis JDK 8 (mars 2014)

Comment ça fonctionne

Duration est pour les quantités basées sur le temps (heures, minutes, secondes). Period est pour les quantités basées sur les dates (années, mois, jours). ChronoUnit.between() pour les différences simples. Tous gèrent correctement les cas limites.

Documentation Associée
Duration ↗ Period ↗
Patterns associés
Date/Time Débutant

java.time API basics

Pre-Java 8
// Mutable, confusing, zero-indexed months
Calendar cal = Calendar.getInstance();
cal.set(2025, 0, 15); // January = 0!
Date date = cal.getTime();
// not thread-safe
Java 8+
LocalDate date = LocalDate.of(
    2025, Month.JANUARY, 15);
LocalTime time = LocalTime.of(14, 30);
Instant now = Instant.now();
// immutable, thread-safe
Survolez pour voir le moderne ➜
JDK 8+ →
Date/Time Débutant

Date formatting

Pre-Java 8
// Not thread-safe!
SimpleDateFormat sdf =
    new SimpleDateFormat("yyyy-MM-dd");
String formatted = sdf.format(date);
// Must synchronize for concurrent use
Java 8+
DateTimeFormatter fmt =
    DateTimeFormatter.ofPattern(
        "uuuu-MM-dd");
String formatted =
    LocalDate.now().format(fmt);
// Thread-safe, immutable
Survolez pour voir le moderne ➜
JDK 8+ →
Date/Time Débutant

Math.clamp()

Java 8
// Clamp value between min and max
int clamped =
    Math.min(Math.max(value, 0), 100);
// or: min and max order confusion
Java 21+
int clamped =
    Math.clamp(value, 0, 100);
// value constrained to [0, 100]
Survolez pour voir le moderne ➜
JDK 21+ →
Partager 𝕏 🦋 in ⬡