Home »
Java »
Java Reference »
Java Clock Class
Java Clock Class | instant() Method with Example
Clock Class instant() method: Here, we are going to learn about the instant() method of Clock Class with its syntax and example.
Submitted by Preeti Jain, on May 13, 2020
Clock Class instant() method
- instant() method is available in java.time package.
- instant() method is used to get the current instant that is used with this Clock.
- instant() method is a non-static method, it is accessible with the class object and if we try to access the method with the class name then we will get an error.
- instant() method may throw an exception at the time of returning instant.
DateTimeException: This exception may throw when no instant couldn’t be generated (i.e. invalid instant is used with this Clock).
Syntax:
public Instant instant();
Parameter(s):
Return value:
The return type of this method is Instant, it returns the present instant that is used with this Clock.
Example:
// Java program to demonstrate the example
// of instant() method of Clock
import java.time.*;
public class InstantOfClock {
public static void main(String args[]) {
// Instantiates two ZoneId for Accra and Asmara
ZoneId zone_1 = ZoneId.of("Africa/Accra");
ZoneId zone_2 = ZoneId.of("Africa/Asmara");
// Initialize two Clock objects
Clock cl1 = Clock.system(zone_1);
Clock cl2 = Clock.system(zone_2);
// returns the current instant value of this Clock cl1
Instant cl_ins = cl1.instant();
// Display cl1 instant
System.out.println("cl1.instant(): " + cl_ins);
// returns the current instant value of this Clock cl2
cl_ins = cl2.instant();
// Display cl2 instant
System.out.println("cl2.instant(): " + cl_ins);
}
}
Output
cl1.instant(): 2020-05-13T18:38:03.026909Z
cl2.instant(): 2020-05-13T18:38:03.077464Z