Strona główna / Date/Time / Duration i Period
Date/Time Początkujący

Duration i Period

Obliczaj różnice czasu z bezpiecznym typowaniem za pomocą Duration i Period.

Porównanie kodu
✕ 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);
Widzisz problem z tym kodem? Daj nam znać.
Dlaczego nowoczesne podejście wygrywa
🎯

Bezpieczne typowanie

Duration dla czasu, Period dla dat — bez pomyłek.

🛡️

Poprawna arytmetyka

Obsługuje przejścia czasu letniego, lata przestępne i sekundy przestępne.

📖

Czytelność

ChronoUnit.DAYS.between() czyta się jak naturalny język.

Stare podejście
Arytmetyka na milisekundach
Nowoczesne podejście
Duration / Period
Od JDK
8
Poziom trudności
Początkujący
Wsparcie JDK
Duration i Period
Dostępne

Szeroko dostępne od JDK 8 (marzec 2014)

Jak to działa

Duration służy do ilości czasu (godziny, minuty, sekundy). Period służy do ilości dat (lata, miesiące, dni). ChronoUnit.between() do prostych różnic. Wszystkie typy poprawnie obsługują przypadki brzegowe.

Powiązana dokumentacja
Duration ↗ Period ↗
Dowód
Zobacz źródło dowodu ↗
Powiązane wzorce
Date/Time Początkujący

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
Najedź, aby zobaczyć nową wersję ➜
JDK 8+ →
Date/Time Początkujący

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
Najedź, aby zobaczyć nową wersję ➜
JDK 8+ →
Date/Time Początkujący

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]
Najedź, aby zobaczyć nową wersję ➜
JDK 21+ →