Java ZonedDateTime range()方法及示例

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

语法

public ValueRange range(TemporalField field)

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

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

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

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

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

程序1 :

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

输出。

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

程序2

// Java program to demonstrate
// ZonedDateTime.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 ZonedDateTime object
        ZonedDateTime zonedDT
            = ZonedDateTime
                  .parse(
                      "2018-10-25T23:12:31.123+02:00[Europe/Paris]");
  
        // print ZonedDateTime
        System.out.println("ZonedDateTime 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);
    }
}

输出。

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

参考资料: https://docs.oracle.com/javase/10/docs/api/java/time/ZonedDateTime.html#range(java.time.temporal.TemporalField)