LocalTime range() method in Java with Examples

range() method of the LocalTime class is used to get the range of field in terms of the minimum and maximum values and the field is passed as a parameter to this method. The returned value for this method is ValueRange object for the field and the method returns ValueRange object only for those fields which are supported by LocalTime object. So when the field is not supported by this method then an exception is thrown by this method.

Syntax:

public ValueRange range(TemporalField field)

Parameters: This method accepts one parameter field which is the field to query the range.

Return value: This method returns the range of valid values for the field.

Exception:This method throws following Exceptions:

• DateTimeException – if the range for the field cannot be obtained.
• UnsupportedTemporalTypeException – if the field is not supported.

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

// Java program to demonstrate
// LocalTime.range() method

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

public class GFG {
    public static void main(String[] args)
    {
        // create LocalTime objects
        LocalTime l1
            = LocalTime
                  .parse("09:21:12");

        // apply range() method of LocalTime class
        ValueRange result
            = l1.range(ChronoField.MILLI_OF_SECOND);

        // print results
        System.out.println("Range in MILLI_OF_SECOND: "
                           + result);
    }
}

Output:

Range in MILLI_OF_SECOND: 0 - 999

Program 2:

// Java program to demonstrate
// LocalTime.range() method

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

public class GFG {
    public static void main(String[] args)
    {
        // create LocalTime objects
        LocalTime l1
            = LocalTime
                  .parse("19:21:12");

        // apply range() method of LocalTime class
        ValueRange result
            = l1.range(ChronoField.MINUTE_OF_HOUR);

        // print results
        System.out.println("Range in MINUTE_OF_HOUR: "
                           + result);
    }
}

Output:

Range in MINUTE_OF_HOUR: 0 - 59

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