Java Duration class

Last Updated : 17 Mar 2025

Java Duration class is used to measures time in seconds and nanoseconds. It inherits the Object class and implements the Comparable interface.

Java Duration class declaration

Let's see the declaration of java.time.Duration class.

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

Methods of Java Duration

Method	Description
Temporal addTo(Temporal temporal)	It is used to add this duration to the specified temporal object.
static Duration between(Temporal startInclusive, Temporal endExclusive)	It is used to obtain a Duration representing the duration between two temporal objects.
long get(TemporalUnit unit)	It is used to get the value of the requested unit.
boolean isNegative()	It is used to check if this duration is negative, excluding zero.
boolean isZero()	It is used to check if this duration is zero length.
Duration minus(Duration duration)	It is used to return a copy of this duration with the specified duration subtracted.
Duration plus(Duration duration)	It is used to return a copy of this duration with the specified duration added.
Duration abs()	It returns a copy of this duration with a positive length.
static Duration between(Temporal startInclusive, Temporal endExclusive)	It obtains a Duration representing the duration between two temporal objects.
int compareTo(Duration otherDuration)	It compares the given duration to the specified Duration.
int getNano()	It gets the number of nanoseconds within the second in this duration.
long getSeconds()	It gets the number of seconds in this duration.
static Duration of(long amount, TemporalUnit unit)	It obtains a Duration representing an amount in the specified unit.
static Duration ofDays(long days)	It obtains a Duration representing a number of standard 24 hour days.
static Duration ofHours(long hours)	It obtains a Duration representing a number of standard hours.
static Duration ofMillis(long millis)	It obtains a Duration representing a number of milliseconds.
static Duration ofMinutes(long minutes)	It obtains a Duration representing a number of standard minutes.
static Duration ofNanos(long nanos)	It obtains a Duration representing a number of nanoseconds.
static Duration ofSeconds(long seconds)	It obtains a Duration representing a number of seconds.

Java Duration Example: get()

DurationExample1.java

import java.time.*;
import java.time.temporal.ChronoUnit;
public class DurationExample1 {
  public static void main(String[] args) {
    Duration d = Duration.between(LocalTime.NOON,LocalTime.MAX);
    System.out.println(d.get(ChronoUnit.SECONDS));  
  }
}

Test it Now

Output:

Java Duration Example: isNegative()

DurationExample2.java

import java.time.*;
public class DurationExample2 {
  public static void main(String[] args) {
	  Duration d1 = Duration.between(LocalTime.MAX,LocalTime.NOON);
	  System.out.println(d1.isNegative());
	  Duration d2 = Duration.between(LocalTime.NOON,LocalTime.MAX);
              System.out.println(d2.isNegative());    
  }
}

Test it Now

Output:

true
false

Java Duration Example: between()

DurationExample3.java

import java.time.*;
import java.time.temporal.ChronoUnit;
public class DurationExample3 {
  public static void main(String[] args) {
    Duration d = Duration.between(LocalTime.NOON,LocalTime.MAX);
    System.out.println(d.get(ChronoUnit.SECONDS));  
  }
}

Test it Now

Output:

Java Duration Example: minus()

DurationExample4.java

import java.time.*;
public class DurationExample4 {
  public static void main(String[] args) {
    Duration d1 = Duration.between(LocalTime.NOON,LocalTime.MAX);
    System.out.println(d1.getSeconds());
    Duration d2 = d1.minus(d1);
    System.out.println(d2.getSeconds());
  }
}

Test it Now

Output:

43199
0

Java Duration Example: plus()

DurationExample5.java

import java.time.*;
public class DurationExample5 {
  public static void main(String[] args) {
    Duration d1 = Duration.between(LocalTime.NOON,LocalTime.MAX);
    System.out.println(d1.getSeconds());
    Duration d2 = d1.plus(d1);
    System.out.println(d2.getSeconds());
  }
}

Test it Now

Output:

43199
86399

Next TopicJava Instant

← prev next →

We deliver comprehensive tutorials, interview question-answers, MCQs, study materials on leading programming languages and web technologies like Data Science, MEAN/MERN full stack development, Python, Java, C++, C, HTML, React, Angular, PHP and much more to support your learning and career growth.