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

// 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);
    }
}

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

// 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);
    }
}

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)