Monday, August 27, 2018

Java8 - java.time.temporal.ChronoUnit enum tutorials with examples

ChronoUnit Examples

java.time.temporal.ChronoUnit is an Enumeration class introduced in java8. This is replaced with integer values representing Days, weeks.. etc. It implements TemporalUnit interface.
It is used to measure the time in Years, Months, Weeks, Days, Hours, Minutes, Seconds, Microseconds, Nanoseconds
It contains the following constants
Nanos Micros Millis Seconds Minutes Hours HalfDays Days Weeks Months
Years Decades Centuries Millennia Eras Forever

Usecases and Usage

This can be used in Date and Time API for calculating below things
specific time before
Specific time after
A number of days, years, months, hours, minutes, seconds between two dates and return range in Units.


We will see various use cases of java.time.temporal.ChronoUnit class

Display all ChronoUnits  in seconds

This is an example of available ChronoUnit and their measure unit in seconds
 for (ChronoUnit unit : ChronoUnit.values()) {
         Duration duration=unit.getDuration();
            System.out.println(unit+" is of seconds:"+duration.getSeconds());
Output is
Nanos is of seconds:0
Micros is of seconds:0
Millis is of seconds:0
Seconds is of seconds:1
Minutes is of seconds:60
Hours is of seconds:3600
HalfDays is of seconds:43200
Days is of seconds:86400
Weeks is of seconds:604800
Months is of seconds:2629746
Years is of seconds:31556952
Decades is of seconds:315569520
Centuries is of seconds:3155695200
Millennia is of seconds:31556952000
Eras is of seconds:31556952000000000
Forever is of seconds:9223372036854775807

How to add/subtract to date using ChronoUnit in java?

This is an example adding and subtracting measure units to LocaldateTime
LocalDateTime now =;
// date time 5 days ago
LocalDateTime localDateTime1 = now.minus(5, ChronoUnit.DAYS);
//  date time 5 years ago
LocalDateTime localDateTime2 = now.minus(5, ChronoUnit.YEARS);
// date time 10 days after
LocalDateTime localDateTime3 =, ChronoUnit.DAYS);
//  date time 4 months after
LocalDateTime localDateTime4 =, ChronoUnit.MONTHS);
The output of the above code execution is

How to calculate a number of years between two dates?

This is an example for finding years between two Localdates.
using ChronoUnit.YEARS.between() method returns the number of years in between dates.
LocalDate dob = LocalDate.of(1980, Month.AUGUST, 24);
LocalDate dateNow =;
long numerOfYears = ChronoUnit.YEARS.between(dob, dateNow);
Output is
How to calculate the number of days between two dates?
This is an example of finding days between two Localdates.
ChronoUnit.DAYS.between() method returns the number of days in between dates.
LocalDate dob = LocalDate.of(1980, Month.AUGUST, 24);
LocalDate dateNow =;
long numberOfDays = ChronoUnit.DAYS.between(dob, dateNow);
Output is

How to get Nano/milli/seconds/minutes/Hours difference between two dates?

This is an example of finding micro time details between two dates.
ChronoUnit.between() method  with micro details gives all micro time information
LocalDateTime dateTime = LocalDateTime.of(2017, 1, 1, 0, 0);
LocalDateTime dateTime1 =;
System.out.println("Differnce in Nano seconds" + ChronoUnit.NANOS.between(dateTime, dateTime1));
System.out.println("Differnce in Milli seconds" + ChronoUnit.MILLIS.between(dateTime, dateTime1));
System.out.println("Differnce in  seconds" + ChronoUnit.SECONDS.between(dateTime, dateTime1));
System.out.println("Differnce in  minutes" + ChronoUnit.MINUTES.between(dateTime, dateTime1));
System.out.println("Differnce in  hours" + ChronoUnit.HOURS.between(dateTime, dateTime1));
Output is

Differnce in Nano seconds52184462355462300
Differnce in Milli seconds52184462355
Differnce in  seconds52184462
Differnce in  minutes869741
Differnce in  hours14495

The same example can be written using java.time.Duration
java.time.Duration example to get hours/mins/secs/milli/nano between two dates.
java.time.Duration.between() method is used to get micro time details
LocalDateTime dateTime = LocalDateTime.of(2017, 1, 1, 0, 0);
LocalDateTime dateTime1 =;
System.out.println("Differnce in Nano seconds" + java.time.Duration.between(dateTime, dateTime1).getNano());
System.out.println("Differnce in Milli seconds" + java.time.Duration.between(dateTime, dateTime1).toMillis());
System.out.println("Differnce in  seconds" + java.time.Duration.between(dateTime, dateTime1).getSeconds());
System.out.println("Differnce in  minutes" + java.time.Duration.between(dateTime, dateTime1).toMinutes());
System.out.println("Differnce in  hours" + java.time.Duration.between(dateTime, dateTime1).toHours());
Output is
Differnce in Nano seconds156614800
Differnce in Milli seconds52183108156
Differnce in  seconds52183108
Differnce in  minutes869718
Differnce in  hours14495

Related article