Início / Date/Time / Duration e Period
Date/Time Iniciante

Duration e Period

Calcule diferenças de tempo com Duration e Period, tipos seguros e precisos.

Comparação 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);
Viu um problema com este código? Nos avise.
Por que a forma moderna ganha
🎯

Tipagem segura

Duration para tempo, Period para datas — sem confusão.

🛡️

Cálculo correto

Lida com horário de verão, anos bissextos e segundos intercalares.

📖

Legível

ChronoUnit.DAYS.between() se lê de forma natural.

Abordagem Antiga
Cálculo com milissegundos
Abordagem Moderna
Duration / Period
Desde o JDK
8
Dificuldade
Iniciante
Suporte JDK
Duration e Period
Disponível

Amplamente disponível desde o JDK 8 (março de 2014)

Como funciona

Duration é para quantidades baseadas em tempo (horas, minutos, segundos). Period é para quantidades baseadas em datas (anos, meses, dias). ChronoUnit.between() serve para diferenças simples. Todos tratam casos extremos corretamente.

Documentação Relacionada
Duration ↗ Period ↗
Padrões relacionados
Date/Time Iniciante

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
Passe o mouse para ver o moderno ➜
JDK 8+ →
Date/Time Iniciante

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
Passe o mouse para ver o moderno ➜
JDK 8+ →
Date/Time Iniciante

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]
Passe o mouse para ver o moderno ➜
JDK 21+ →
Compartilhar 𝕏 🦋 in ⬡