Instant equals() method in Java with Examples

The equals(Object otherInstant) method of Instant class is used to compare this Instant to the Instant object passed as parameter. The comparison between both instances is based on the time-line position of the instants. The value to be returned by this method is determined as follows:

  • if both instances are equal, then true is returned
  • if both instances are not equal, then false is returned.

Syntax:

public boolean equals(Object otherInstant)

Parameters: This method accepts a mandatory parameter otherInstant which is the other instant to be compared, and it should not be null.



Return Value: This method returns a boolean value as follows:

  • true: if both instances are equal.
  • false: if both instances are not equal.

Below programs illustrate the Instant.equals() method:

Program 1: When both instances are equal

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java program to demonstrate
// Instant.equals() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create two instance objects
        Instant instant1
            = Instant.parse("2018-10-20T16:55:30.00Z");
  
        Instant instant2
            = Instant.parse("2018-10-20T16:55:30.00Z");
  
        // print Instant Values
        System.out.println("Instant1: "
                           + instant1);
        System.out.println("Instant2: "
                           + instant2);
  
        // compare both instant
        boolean value = instant1.equals(instant2);
  
        // print results
        System.out.println("Are both instants are equal: "
                           + value);
    }
}

chevron_right


Output:

Instant1: 2018-10-20T16:55:30Z
Instant2: 2018-10-20T16:55:30Z
Are both instants are equal: true

Program 2: When both instances are not equal

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java program to demonstrate
// Instant.equals() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create two instance objects
        Instant instant1
            = Instant.parse("2018-10-20T16:55:30.00Z");
  
        Instant instant2
            = Instant.parse("2011-10-20T16:55:30.00Z");
  
        // print Instant Values
        System.out.println("Instant1: "
                           + instant1);
        System.out.println("Instant2: "
                           + instant2);
  
        // compare both instant
        boolean value = instant1.equals(instant2);
  
        // print results
        System.out.println("Are both instants are equal: "
                           + value);
    }
}

chevron_right


Output:

Instant1: 2018-10-20T16:55:30Z
Instant2: 2011-10-20T16:55:30Z
Are both instants are equal: false

Reference: https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#equals(java.lang.Object)



My Personal Notes arrow_drop_up

I am a Developer I love to code and bring my ideas alive

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.



Improved By : Kirti_Mangal