Home » Java » Java Reference » Java Instant Class

Java Instant Class | getLong() Method with Example

Instant Class getLong() method: Here, we are going to learn about the getLong() method of Instant Class with its syntax and example.
Submitted by Preeti Jain, on May 24, 2020

Instant Class getLong() method

• getLong() method is available in java.time package.
• getLong() method is used to get the value as long for the given temporal field from this Instant.
• getLong() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• getLong() method may throw an exception at the time of returning value as long.
  • DateTimeException: This exception may throw when the given field couldn't be generated.
  • UnsupportedTemporalTypeException: This exception may throw when the given field is unsupported.
  • ArithmeticException: This exception may throw when the calculated result exceeds the limit.

Syntax:

    public long getLong(TemporalField t_field);

Parameter(s):

• TemporalField t_field – represents the field of the returned value.

Return value:

The return type of this method is long, it returns the value of the given field in a long from this Instant.

Example:

// Java program to demonstrate the example 
// of getLong(TemporalField t_field) method 
// of Instant

import java.time.*;
import java.time.temporal.*;

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

        // Instantiates two Instant
        Instant ins1 = Instant.parse("2006-04-03T05:10:15.20Z");
        Instant ins2 = Instant.parse("2007-06-05T10:20:30.20Z");

        // Display ins1,ins2
        System.out.println("Instant ins1 and ins2: ");
        System.out.println("ins1: " + ins1);
        System.out.println("ins2: " + ins2);

        System.out.println();

        // Here, this method gets the value of the 
        // given field from this Instant i.e.
        // here the MICRO_OF_SECOND field value
        // will be returned from this Instant ins1
        // as long
        long get_val = ins1.getLong(ChronoField.MICRO_OF_SECOND);

        // Display get_val
        System.out.println("ins1.getLong(ChronoField.MICRO_OF_SECOND): " + get_val);

        // Here, this method gets the value of the 
        // given field from this Instant i.e.
        // here the MILLI_OF_SECOND field value
        // will be returned from this Instant ins2
        // as long
        get_val = ins2.getLong(ChronoField.MILLI_OF_SECOND);

        // Display get_val
        System.out.println("ins2.getLong(ChronoField.MILLI_OF_SECOND): " + get_val);
    }
}

Output

Instant ins1 and ins2: 
ins1: 2006-04-03T05:10:15.200Z
ins2: 2007-06-05T10:20:30.200Z

ins1.getLong(ChronoField.MICRO_OF_SECOND): 200000
ins2.getLong(ChronoField.MILLI_OF_SECOND): 200