Instant get() method in Java with Examples

The get() method of Instant class helps to get the value for the specified field passed as parameter from this instant as an integer value. This method queries this instant for the value of the field and the returned value will always be within the valid range of values for the field. When the field is not supported and method is unable to return int value then an exception is thrown.

Syntax:

public int get(TemporalField field)

Parameters: This method accepts one parameter field which is the field to get.
Returns: This method returns int value for the field.

Exception: This method throws the following exceptions:  

• DateTimeException: if a value for the field cannot be obtained or the value is outside the range of valid values for the field.
• UnsupportedTemporalTypeException: if the field is not supported or the range of values exceeds an int.
• ArithmeticException: if numeric overflow occurs.

Below programs illustrate the get() method:

Program 1:

Java

// Java program to demonstrate
// Instant.get() method

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

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

        // create a Instant object
        Instant instant
            = Instant.parse("2018-12-30T19:34:50.63Z");

        // get Milli of Second value from instant
        // using get method
        int secondvalue
            = instant.get(ChronoField.MILLI_OF_SECOND);

        // print result
        System.out.println("MilliSecond Field: "
                           + secondvalue);
    }
}

Output

MilliSecond Field: 630

Program 2:

Java

// Java program to demonstrate
// Instant.get() method

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

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

        // create a Instant object
        Instant instant
            = Instant.parse("2018-12-30T01:34:50.93Z");

        // get Nano of Second value from instant
        // using get method
        int secondvalue
            = instant.get(ChronoField.NANO_OF_SECOND);

        // print result
        System.out.println("Nano of Second: "
                           + secondvalue);
    }
}

Output:

Nano of Second: 930000000

Program 3: To get UnsupportedTemporalTypeException 

Java

// Java program to demonstrate
// Instant.get() method

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

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

        // create a Instant object
        Instant instant
            = Instant.parse("2018-12-30T01:34:50.93Z");

        // try to find era using ChronoField
        try {

            int secondvalue
                = instant.get(ChronoField.ERA);
        }
        catch (Exception e) {

            // print exception
            System.out.println("Exception: " + e);
        }
    }
}

Output:

Exception:
 java.time.temporal.UnsupportedTemporalTypeException:
 Unsupported field: Era

References: https://docs.oracle.com/javase/10/docs/api/java/time/Instant.html#get(java.time.temporal.TemporalField)