Sunday, July 26, 2026
HomeLanguagesJavaInstant plusMillis() method in Java with Examples

Instant plusMillis() method in Java with Examples

The plusMillis() method of Instant class adds specified duration in milliseconds to this instant and returns the result as an instant object. This returned Instant is immutable.

Syntax:

public Instant plusMillis(long millisToAdd)

Parameters: This method accepts one parameter millisToAdd which is milliseconds to add.

Returns: This method returns Instant with the milliseconds added to it.

Exception: This method throws following exceptions:

  • DateTimeException: if the result exceeds the maximum or minimum instant.
  • ArithmeticException: if numeric overflow occurs.

Below programs illustrate the plusMillis() method:

Program 1:




// Java program to demonstrate
// Instant.plusMillis() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a Instant object
        Instant instant
            = Instant.parse("2018-12-30T19:34:50.63Z");
  
        // addition of 8800000 MILLI_OF_SECOND
        // means 8800 seconds to this instant
        Instant returnedValue
            = instant.plusMillis(8800000);
  
        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}


Program 2:




// Java program to demonstrate
// Instant.plusMillis() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a Instant object
        Instant instant = Instant.now();
  
        // current Instant
        System.out.println("Current instant: "
                           + instant);
  
        // addition of 420000 MILLI_OF_SECOND
        // means 420 seconds to this instant
        Instant returnedValue
            = instant.plusMillis(420000);
  
        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}


References: https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#plusMillis(long)

RELATED ARTICLES

4 COMMENTS

Most Popular

Dominic
32520 POSTS0 COMMENTS
Milvus
131 POSTS0 COMMENTS
Nango Kala
6903 POSTS0 COMMENTS
Nicole Veronica
12017 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12115 POSTS0 COMMENTS
Shaida Kate Naidoo
7023 POSTS0 COMMENTS
Ted Musemwa
7265 POSTS0 COMMENTS
Thapelo Manthata
6980 POSTS0 COMMENTS
Umr Jansen
6972 POSTS0 COMMENTS