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):

• None

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