Instant minusSeconds() method in Java with Examples

Last Updated : 27 Nov, 2018

The minusSeconds() method of Instant class subtracts specified second value from this instant and return the result as an instant object. This instant is immutable.

Syntax:

public Instant minusSeconds(long secondsToSubtract)

Parameters: This method accepts one parameter secondsToSubtract which is seconds to be subtracted.

Returns: This method returns Instant after subtraction of seconds.

Exception: This method throws following excpetions:

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

Below programs illustrate the minusSeconds() method:

Program 1:

// Java program to demonstrate
// Instant.minusSeconds() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a Instant object
        Instant instant
            = Instant.parse("2018-10-30T09:05:55.13Z");
  
        // current Instant
        System.out.println("Initailize instant: "
                           + instant);
  
        // subtract 4300 seconds from this instant
        Instant returnedValue
            = instant.minusSeconds(4300);
  
        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}

Output:

Initailize instant: 2018-10-30T09:05:55.130Z
Returned Instant: 2018-10-30T07:54:15.130Z

Program 2:

// Java program to demonstrate
// Instant.minusSeconds() 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);
  
        // subtract 54000 from this instant
        Instant returnedValue
            = instant.minusSeconds(54000);
  
        // print result
        System.out.println("Returned Instant: "
                           + returnedValue);
    }
}

Output:

Current instant: 2018-11-27T06:44:04.901Z
Returned Instant: 2018-11-26T15:44:04.901Z

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

Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready. To complete your preparation from learning a language to DS Algo and many more, please refer Complete Interview Preparation Course.

My Personal Notes

Related Articles