Home / Date/Time / Duration e Period
Date/Time Principiante

Duration e Period

Calcola le differenze di tempo con Duration e Period type-safe.

Confronto Codice
✕ 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);
Vedi un problema con questo codice? Faccelo sapere.
Perché vince l'approccio moderno
🎯

Type-safe

Duration per il tempo, Period per le date — nessuna confusione.

🛡️

Calcoli corretti

Gestisce le transizioni DST, gli anni bisestili e i secondi intercalari.

📖

Leggibile

ChronoUnit.DAYS.between() si legge come in inglese.

Approccio Vecchio
Aritmetica in millisecondi
Approccio Moderno
Duration / Period
Dal JDK
8
Difficoltà
Principiante
Supporto JDK
Duration e Period
Disponibile

Ampiamente disponibile dal JDK 8 (marzo 2014)

Come funziona

Duration è per quantità basate sul tempo (ore, minuti, secondi). Period è per quantità basate sulla data (anni, mesi, giorni). ChronoUnit.between() per differenze semplici. Tutti gestiscono correttamente i casi limite.

Documentazione Correlata
Duration ↗ Period ↗
Pattern correlati
Date/Time Principiante

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
Passa il mouse per vedere il moderno ➜
JDK 8+ →
Date/Time Principiante

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
Passa il mouse per vedere il moderno ➜
JDK 8+ →
Date/Time Principiante

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]
Passa il mouse per vedere il moderno ➜
JDK 21+ →
Condividi 𝕏 🦋 in ⬡