Java8 java.time.Duration class with examples

what is java.time.Duration class in java8

java.time.Duration is an object introduced in java8. This is a measurement to find micro time information between two dates.

This measures time in micro and nano seconds.

This is a useful finding period between various Date and Time API classes.

This is an immutable class, Once created, we can not change its value and thread-safety class.


public final class Duration
        implements TemporalAmount, Comparable<Duration>, Serializable

Duration class internally store the two below values Nanoseconds - which is value less than seconds Seconds - which is a value greater than seconds.

This is different from OLD API java.util Date which uses milliseconds getNanos() method - this method used to get the nanoseconds getSeconds() method- this method to get seconds

How to get hours/mins/secs/mill/nano between two dates?

This is an example for converting Duration Object to other units using below methods

  • toNanos()
  • toMillis()
  • toMinutes()
  • toHours()
  • toDays() We already saw getNanos() method which is different from toNanos() getNanos() always return value less than seconds toNanos() returns full nano seconds of Duration object.
import java.time.LocalDateTime;

public class Test {
    public static void main(String[] args) {
        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());


Differnce in Nano seconds644942100
Differnce in Milli seconds52185645644
Differnce in  seconds52185645
Differnce in  minutes869760
Differnce in  hours14496

How to add/subtract hours/minutes/seconds for duration in java8?

Duration class provides various methods for adding/subtract nanos, milli,seconds,minutes and days .

  • plusNanos()
  • plusMillis()
  • plusSeconds()
  • plusMinutes()
  • plusHours()
  • plusDays()
  • minusNanos()
  • minusMillis()
  • minusSeconds()
  • minusMinutes()
  • minusHours()
  • minusDays() Please see the method usage with example below
import java.time.Duration;
import java.time.LocalTime;

public class Test {
    public static void main(String[] args) {
        Duration duration = Duration.between(LocalTime.MIDNIGHT,LocalTime.NOON);
        duration = duration.plusSeconds(400);
        duration = duration.minusSeconds(400);




In this tutorial, Learned java.time.Duration class in java8 and discussed examples using methods