Java中的 ChronoLocalDateTime range() 方法及示例

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

句法：

default ValueRange range(TemporalField field)

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

返回值：该方法返回ValueRange ，它是字段有效值的范围，不为null。

异常：此方法抛出以下异常：

• DateTimeException – 如果无法获取该字段的范围。
• UnsupportedTemporalTypeException – 如果不支持该字段。

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

方案一：

// 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

方案二：

// 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-