Home » Java » Java Reference » Java Duration Class

Java Duration Class | plusMillis() Method with Example

Duration Class plusMillis() method: Here, we are going to learn about the plusMillis() method of Duration Class with its syntax and example.
Submitted by Preeti Jain, on May 16, 2020

Duration Class plusMillis() method

• plusMillis() method is available in java.time package.
• plusMillis() method is used to add the given duration in milliseconds to this Duration and return the Duration.
• plusMillis() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• plusMillis() method may throw an exception at the time of performing addition.
  ArithmeticException: This exception may throw when the calculated results exceed the length of this Duration.

Syntax:

    public Duration plusMillis(long millis_val);

Parameter(s):

• long millis_val – represents the milliseconds value to add to this Duration.

Return value:

The return type of this method is Duration, it returns the Duration that holds the value added the given milliseconds to this Duration.

Example:

// Java program to demonstrate the example 
// of plusMillis(long millis_val) method of Duration

import java.time.*;

public class PlusMillisOfDuration {
    public static void main(String args[]) {
        long millis = 2;

        // Instantiates two Duration objects
        Duration du1 = Duration.ofMillis(5);
        Duration du2 = Duration.ofSeconds(2);

        // Display du1, du2 
        System.out.println("du1: " + du1);
        System.out.println("du2: " + du2);
        System.out.println("millis to add: " + millis);

        System.out.println();

        // adds the given duration in milliseconds with 
        // this Duration du1  and returns the Duration 
        // i.e. here we  are adding the given 2 milliseconds
        // with this du1 that holds the value of 5 
        // milliseconds
        Duration plus_val = du1.plusMillis(millis);

        // Display plus_val
        System.out.println("du1.plusMillis(millis): " + plus_val);

        // adds the given duration in milliseconds with 
        // this Duration du2  and returns the Duration 
        // i.e. here we  are adding the given 2 milliseconds
        // with this du2 that holds the value of 2 seconds
        plus_val = du2.plusMillis(millis);

        // Display plus_val
        System.out.println("du2.plusMillis(millis): " + plus_val);
    }
}

Output

du1: PT0.005S
du2: PT2S
millis to add: 2

du1.plusMillis(millis): PT0.007S
du2.plusMillis(millis): PT2.002S