Startseite / Date/Time / Duration und Period
Date/Time Einsteiger

Duration und Period

Berechne Zeitdifferenzen typsicher mit Duration und Period.

Code-Vergleich
✕ 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);
Problem mit diesem Code entdeckt? Sag uns Bescheid.
Warum der moderne Weg gewinnt
🎯

Typsicher

Duration für Zeit, Period für Datum — keine Verwechslungen.

🛡️

Korrekte Berechnung

Behandelt Sommerzeitumstellungen, Schaltjahre und Schaltsekunden.

📖

Lesbar

ChronoUnit.DAYS.between() liest sich wie natürliche Sprache.

Alter Ansatz
Millisekunden-Arithmetik
Moderner Ansatz
Duration / Period
Seit JDK
8
Schwierigkeitsgrad
Einsteiger
JDK-Unterstützung
Duration und Period
Verfügbar

Weitgehend verfügbar seit JDK 8 (März 2014)

Wie es funktioniert

Duration steht für zeitbasierte Mengen (Stunden, Minuten, Sekunden). Period steht für datumsbasierte Mengen (Jahre, Monate, Tage). ChronoUnit.between() eignet sich für einfache Differenzen. Alle Klassen behandeln Sonderfälle korrekt.

Zugehörige Dokumentation
Duration ↗ Period ↗
Verwandte Muster
Date/Time Einsteiger

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
Hover für Modernes ➜
JDK 8+ →
Date/Time Einsteiger

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
Hover für Modernes ➜
JDK 8+ →
Date/Time Einsteiger

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]
Hover für Modernes ➜
JDK 21+ →
Teilen 𝕏 🦋 in ⬡