Year range() method in Java with Examples

Last Updated : 28 Jan, 2019

range() method of the Year 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 Year object. So when the field is not supported by this method, 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 
// Year.range() method 
  
import java.time.*; 
import java.time.temporal.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
        // create Year object 
        Year year 
            = Year.of(2017); 
  
        // apply range() method of Year class 
        ValueRange result 
            = year.range(ChronoField.ERA); 
  
        // print results 
        System.out.println("Range in ERA: "
                           + result); 
    } 
} 

Output:

Range in ERA: 0 - 1

Program 2:

// Java program to demonstrate 
// Year.range() method 
  
import java.time.*; 
import java.time.temporal.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
        // create Year object 
        Year year 
            = Year.of(2017); 
  
        // apply range() method of Year class 
        ValueRange result 
            = year.range(ChronoField.YEAR); 
  
        // print results 
        System.out.println("Range in YEAR: "
                           + result); 
    } 
} 