Java ChronoZonedDateTime range()方法及示例

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

语法

default ValueRange range(TemporalField field)

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

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

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

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

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

程序1 :

// Java program to demonstrate
// ChronoZonedDateTime.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 ChronoZonedDateTime object
        ChronoZonedDateTime zonedDT
            = ZonedDateTime
                  .parse(
                      "2018-12-06T19:21:12.123+05:30[Asia/Calcutta]");
  
        // print ChronoZonedDateTime
        System.out.println("ChronoZonedDateTime of Calcutta: "
                           + zonedDT);
  
        // get range of MILLI_OF_SECOND field
        // from ChronoZonedDateTime using range method
        ValueRange range
            = zonedDT.range(ChronoField.MILLI_OF_SECOND);
  
        // print range of MILLI_OF_SECOND
        System.out.println("Range of MILLI_OF_SECOND: "
                           + range);
    }
}

输出:

ChronoZonedDateTime of Calcutta: 2018-12-06T19:21:12.123+05:30[Asia/Calcutta]
Range of MILLI_OF_SECOND: 0 - 999

程序2

// Java program to demonstrate
// ChronoZonedDateTime.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 ChronoZonedDateTime object
        ChronoZonedDateTime zonedDT
            = ZonedDateTime
                  .parse(
                      "2018-10-25T23:12:31.123+02:00[Europe/Paris]");
  
        // print ChronoZonedDateTime
        System.out.println("ChronoZonedDateTime of Calcutta: "
                           + zonedDT);
  
        // get range of NANO_OF_SECOND field
        // from zonedDateTime using range method
        ValueRange range
            = zonedDT.range(ChronoField.NANO_OF_SECOND);
  
        // print range of NANO_OF_SECOND
        System.out.println("Range of NANO_OF_SECOND: "
                           + range);
    }
}

输出:

ChronoZonedDateTime of Calcutta: 2018-10-25T23:12:31.123+02:00[Europe/Paris]
Range of NANO_OF_SECOND: 0 - 999999999

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