Course contentsShow
← Java
Lesson 1866 of 2,87038. Date and Time API (java.time)Free lesson

ChronoUnit for Flexible Temporal Calculations

Use ChronoUnit enum to calculate differences and perform temporal arithmetic with various units of time.

ChronoUnit for Flexible Temporal Calculations

You'll learn how to use the ChronoUnit enum to measure time differences and perform arithmetic across any temporal unit in a unified, flexible way.

What Is ChronoUnit?

While Duration and Period work well for their specific domains (time-based and date-based), ChronoUnit is a versatile enum that provides a single, consistent interface for temporal calculations across all units—from nanoseconds to millennia. Think of it as a universal ruler that can measure and manipulate time in whatever unit you need.

Calculating Differences with between()

The ChronoUnit.between() method calculates the complete units between two temporal objects:

LocalDate start = LocalDate.of(2024, 1, 1);
LocalDate end = LocalDate.of(2024, 12, 31);

long days = ChronoUnit.DAYS.between(start, end);       // 365
long months = ChronoUnit.MONTHS.between(start, end);   // 11
long weeks = ChronoUnit.WEEKS.between(start, end);     // 52

Works with time-based temporals too:

LocalTime morning = LocalTime.of(9, 0);
LocalTime evening = LocalTime.of(17, 30);

long hours = ChronoUnit.HOURS.between(morning, evening);     // 8
long minutes = ChronoUnit.MINUTES.between(morning, evening); // 510

Temporal Arithmetic

You can add or subtract units directly using the temporal object's plus() and minus() methods:

LocalDateTime now = LocalDateTime.now();
LocalDateTime later = now.plus(3, ChronoUnit.WEEKS);
LocalDateTime earlier = now.minus(90, ChronoUnit.MINUTES);

This approach is more flexible than Duration or Period when you need different units in different contexts.

When to Use ChronoUnit

Use ChronoUnit when you need unit-agnostic calculations, want a single method for all units, or are working with dynamic unit selection (like user input specifying "days" vs "hours").

Key Takeaway: ChronoUnit provides a flexible enum-based approach for temporal calculations, offering between() for measuring differences and seamless integration with temporal arithmetic for any unit of time.