The range() method of a LocalDate class is used to get the range of valid values for the field passes as a parameter. This method returns ValueRange object which contains the minimum and maximum valid values for a field. When the field is not supported then an exception is thrown. This LocalDate is helpful to enhance the accuracy of the returned range.
Syntax:
public ValueRange range(TemporalField field)
Parameters: This method accepts one single parameter field which is the field to query the range for.
Return value: This method returns ValueRange which is the range of valid values for the field, not null.
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// LocalDate.range() method import java.time.*;import java.time.temporal.ChronoField;import java.time.temporal.ValueRange; public class GFG { public static void main(String[] args) { // create a LocalDate object LocalDate localD = LocalDate.parse("2018-12-06"); // print LocalDate System.out.println("LocalDate: " + localD); // get range of Days field // from LocalDate using range method ValueRange range = localD.range(ChronoField.DAY_OF_MONTH); // print range of DAY_OF_MONTH System.out.println("Range of DAY_OF_MONTH: " + range); }} |
Output:
LocalDate: 2018-12-06 Range of DAY_OF_MONTH: 1 - 31
Program 2:
// Java program to demonstrate// LocalDate.range() method import java.time.*;import java.time.temporal.ChronoField;import java.time.temporal.ValueRange; public class GFG { public static void main(String[] args) { // create a LocalDate object LocalDate localD = LocalDate.parse("2018-12-06"); // print LocalDate System.out.println("LocalDate: " + localD); // get range of DAY_OF_YEAR field // from LocalDate using range method ValueRange range = localD.range(ChronoField.DAY_OF_YEAR); // print range of DAY_OF_YEAR System.out.println("Range of DAY_OF_YEAR: " + range); }} |
Output:
LocalDate: 2018-12-06 Range of DAY_OF_YEAR: 1 - 365
