OffsetDateTime getLong() method in Java with examples

Last Updated : 13 Dec, 2018

The getLong() method of OffsetDateTime class in Java gets the value of the specified field from this date-time as an long. Syntax :

public long getLong(TemporalField field)

Parameter: This method accepts a single parameter field which specifies the field to get, not null. Return Value: It returns the value for the field. Exceptions: The function throws three exceptions which are described below:

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

Below programs illustrate the getLong() method: Program 1 :

Java

// Java program to demonstrate the getLong() method
import java.time.OffsetDateTime;
import java.time.temporal.ChronoField;

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

        // parses a date
        OffsetDateTime date = OffsetDateTime.parse("2018-12-03T12:30:30+01:00");

        // Prints the value of the specified
        // field from this date-time as an long.
        System.out.println(date.getLong(ChronoField.CLOCK_HOUR_OF_DAY));
    }
}

Output:

Program 2 :

Java

// Java program to demonstrate the getDayOfYear() method
// exceptions

import java.time.OffsetDateTime;
import java.time.temporal.ChronoField;

public class GFG {
    public static void main(String[] args)
    {
        try {
            // parses a date
            OffsetDateTime date = OffsetDateTime.parse("2018-24-03T12:30:30+01:00");

            // Prints the value of the specified
            // field from this date-time as an long.
            System.out.println(date.getLong(ChronoField.CLOCK_HOUR_OF_DAY));
        }
        catch (Exception e) {
            System.out.println(e);
        }
    }
}

Output:

java.time.format.DateTimeParseException: 
Text '2018-24-03T12:30:30+01:00' could not be parsed: 
Invalid value for MonthOfYear (valid values 1 - 12): 24

Reference: https://docs.oracle.com/javase/8/docs/api/java/time/temporal/TemporalField.html