Java的.time.temporal.ValueRange类在Java中

在Java 8中，日期和时间API引入了一个新的类：ValueRange。该类主要用于表示时间线上的一段时间或一个日期的有效值范围。

ValueRange的定义

ValueRange类定义如下：

public final class ValueRange implements Serializable {
   private final long minSmallest;
   private final long minLargest;
   private final long maxSmallest;
   private final long maxLargest;
   ...
}

ValueRange的构造器

ValueRange类提供了两个构造函数，可以选择使用long型或TemporalField类型来表示值范围的最小值和最大值。例如：

ValueRange.of(long min, long max);
ValueRange.of(TemporalField field);

ValueRange的方法

getMinimum()

获取最小值。

long getMinimum();

getMaximum()

获取最大值。

long getMaximum();

isFixed()

检查值范围是否固定（即最大值和最小值相等）。

boolean isFixed();

isIntValue()

检查值范围是否表示为int类型。

boolean isIntValue();

isValidValue(long value)

检查给定值是否在有效范围内。

boolean isValidValue(long value);

checkValidValue(long value, TemporalField field)

检查值是否在给定的TemporalField中是有效值。

long checkValidValue(long value, TemporalField field);

checkValidIntValue(long value, TemporalField field)

检查int类型的值是否在给定的TemporalField中是有效值。

int checkValidIntValue(long value, TemporalField field);

示例

以下是一个示例程序，演示如何使用ValueRange类：

import java.time.temporal.TemporalField;
import java.time.temporal.ValueRange;

public class ValueRangeDemo {
    public static void main(String[] args) {
        TemporalField field = WeekFields.ISO.dayOfWeek();
        ValueRange range = field.range();
        
        System.out.println("Minimum value: " + range.getMinimum()); 
        System.out.println("Maximum value: " + range.getMaximum()); 
        System.out.println("Is fixed: " + range.isFixed()); 
        System.out.println("Is int value: " + range.isIntValue()); 
        System.out.println("Is valid value (2): " + range.isValidValue(2)); 
        System.out.println("Is valid value (8): " + range.isValidValue(8)); 
    }
}

输出结果：

Minimum value: 1
Maximum value: 7
Is fixed: true
Is int value: true
Is valid value (2): true
Is valid value (8): false

总结

ValueRange类为处理日期和时间相关的应用程序提供了一种方便的方式来表示时间线上的一段时间或一个日期的有效值范围。通过这个类，程序员可以轻松地检查给定的值是否在有效范围内，从而更好地控制应用程序的行为。