Java ChronoLocalDateTime range()方法及示例

ChronoLocalDateTime 接口的 range() 方法是用来获取作为参数传递的字段的有效值范围。该方法返回一个ValueRange对象，其中包含一个字段的最小和最大有效值。这个ChronoLocalDateTime有助于提高返回范围的准确性。当该字段不被支持且该方法无法返回范围值时，就会抛出一个异常。

语法

default ValueRange range(TemporalField field)

参数： 该方法接受一个单参数 字段 ，该字段是要获得数值范围的字段。

返回值： 该方法返回 ValueRange ，即该字段的有效值范围，而不是空值。

异常： 该方法会抛出以下异常。

• DateTimeException – 如果不能获得该字段的范围。
• UnsupportedTemporalTypeException – 如果该字段不被支持。

下面的程序说明了range()方法。

程序1 :

// Java program to demonstrate
// ChronoLocalDateTime.range() method
  
import java.time.*;
import java.time.chrono.*;
import java.time.temporal.ChronoField;
import java.time.temporal.ValueRange;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ChronoLocalDateTime object
        ChronoLocalDateTime localDT
            = LocalDateTime
                  .parse("2018-10-25T23:12:31.123");
  
        // print ChronoLocalDateTime
        System.out.println("ChronoLocalDateTime of Calcutta: "
                           + localDT);
  
        // get range of MILLI_OF_SECOND field
        // from ChronoLocalDateTime using range method
        ValueRange range
            = localDT.range(ChronoField.MILLI_OF_SECOND);
  
        // print range of MILLI_OF_SECOND
        System.out.println("Range of MILLI_OF_SECOND: "
                           + range);
    }
}

输出:

ChronoLocalDateTime of Calcutta: 2018-10-25T23:12:31.123
Range of MILLI_OF_SECOND: 0 - 999

程序2

// Java program to demonstrate
// ChronoLocalDateTime.range() method
  
import java.time.*;
import java.time.chrono.*;
import java.time.temporal.ChronoField;
import java.time.temporal.ValueRange;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a ChronoLocalDateTime object
        ChronoLocalDateTime localDT
            = LocalDateTime
                  .parse("2019-12-31T19:15:30");
  
        // print ChronoLocalDateTime
        System.out.println("ChronoLocalDateTime of Calcutta: "
                           + localDT);
  
        // get range of NANO_OF_SECOND field
        // from localDateTime using range method
        ValueRange range
            = localDT.range(ChronoField.NANO_OF_SECOND);
  
        // print range of NANO_OF_SECOND
        System.out.println("Range of NANO_OF_SECOND: "
                           + range);
    }
}

输出:

ChronoLocalDateTime of Calcutta: 2019-12-31T19:15:30
Range of NANO_OF_SECOND: 0 - 999999999

参考资料: https://docs.oracle.com/javase/9/docs/api/java/time/temporal/TemporalAccessor.html#range-java.time.temporal.TemporalField-