OffsetDateTime getLong() method in Java with examples

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

12

Program 2 :

// 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