Java Instant range()方法及示例

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

语法

public ValueRange range(TemporalField field)

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

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

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

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

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

程序1 :

// Java program to demonstrate
// Instant.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 Instant object
        Instant instant
            = Instant.parse("2018-10-28T19:34:50.63Z");
  
        // print Instant
        System.out.println("Instant: "
                           + instant);
  
        // get range of MILLI_OF_SECOND field
        // from instant using range method
        ValueRange range
            = instant.range(ChronoField.MILLI_OF_SECOND);
  
        // print range of MILLI_OF_SECOND
        System.out.println("Range of MILLI_OF_SECOND: "
                           + range);
    }
}

程序2

// Java program to demonstrate
// Instant.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 Instant object
        Instant instant
            = Instant.parse("2018-10-28T19:34:50.63Z");
  
        // print Instant
        System.out.println("Instant: "
                           + instant);
  
        // get range of NANO_OF_SECOND field
        // from instant using range method
        ValueRange range
            = instant.range(ChronoField.NANO_OF_SECOND);
  
        // print range of NANO_OF_SECOND
        System.out.println("Range of NANO_OF_SECOND: "
                           + range);
    }
}

程序3： 获取UnsupportedTemporalTypeException

// Java program to demonstrate
// Instant.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 Instant object
        Instant instant
            = Instant.parse("2018-10-28T19:34:50.63Z");
  
        // try to find range of era using ChronoField
        try {
  
            ValueRange secondvalue
                = instant.range(ChronoField.ERA);
        }
        catch (Exception e) {
  
            // print exception
            System.out.println("Exception: " + e);
        }
    }
}

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