LocalDate range() method in Java with Examples

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:

filter_none

edit
close

play_arrow

link
brightness_4
code

// 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);
    }
}

chevron_right


Output:

LocalDate: 2018-12-06
Range of DAY_OF_MONTH: 1 - 31

Program 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

// 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);
    }
}

chevron_right


Output:

LocalDate: 2018-12-06
Range of DAY_OF_YEAR: 1 - 365

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

java-img




My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.