Inicio / Date/Time / Duration y Period
Date/Time Principiante

Duration y Period

Calcula diferencias de tiempo con Duration y Period con tipado seguro.

Comparación de Código
✕ 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);
¿Ves un problema con este código? Cuéntanos.
Por qué gana la forma moderna
🎯

Tipado seguro

Duration para tiempo, Period para fechas — sin confusión.

🛡️

Cálculo correcto

Maneja transiciones de horario de verano, años bisiestos y segundos intercalares.

📖

Legible

ChronoUnit.DAYS.between() se lee como lenguaje natural.

Enfoque Antiguo
Aritmética con milisegundos
Enfoque Moderno
Duration / Period
Desde JDK
8
Dificultad
Principiante
Soporte JDK
Duration y Period
Disponible

Ampliamente disponible desde JDK 8 (marzo de 2014)

Cómo funciona

Duration es para cantidades basadas en tiempo (horas, minutos, segundos). Period es para cantidades basadas en fechas (años, meses, días). ChronoUnit.between() para diferencias simples. Todos manejan correctamente los casos límite.

Documentación Relacionada
Duration ↗ Period ↗
Patrones relacionados
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
Pasa el ratón para ver el 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
Pasa el ratón para ver el 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]
Pasa el ratón para ver el moderno ➜
JDK 21+ →
Compartir 𝕏 🦋 in ⬡