java.time.Instant.compareTo() Method Example

Description

The java.time.Instant.compareTo(Instant otherInstant) method compares this instant to the specified instant.

Declaration

Following is the declaration for java.time.Instant.compareTo(Instant otherInstant) method.

public int compareTo(Instant otherInstant)

Parameters

otherInstant − the other instant to compare to, not null.

Return Value

the comparator value, negative if less, positive if greater.

Exceptions

NullPointerException − if otherInstant is null.

Example

The following example shows the usage of java.time.Instant.compareTo(Instant otherInstant) method.

package com.tutorialspoint;

import java.time.Instant;
import java.time.OffsetDateTime;
import java.time.ZoneId;
import java.time.ZoneOffset;
import java.time.ZonedDateTime;
import java.util.Set;

public class InstantDemo {
   public static void main(String[] args) {

      Instant instant = Instant.parse("2017-02-03T10:37:30.00Z");
      System.out.println("Instant #1: " + instant);  

      Instant instant1 = Instant.parse("2017-03-03T10:37:30.00Z");
      System.out.println("Instant #2: " + instant1);  

      int result = instant.compareTo(instant1);
      System.out.println(result >1 ? "Instant #1 is greater than Instant #2."
         :"Instant #2 is greater than Instant #1.");  
   }
}

Let us compile and run the above program, this will produce the following result −

Instant #1: 2017-02-03T10:37:30Z
Instant #2: 2017-03-03T10:37:30Z
Instant #2 is greater than Instant #1.