ValueRange (Java Platform SE 8)

java.lang.Object
- java.time.temporal.ValueRange

すべての実装されたインタフェース:

Serializable
```
public final class ValueRange
extends Object
implements Serializable
```
日付/時間フィールドの有効な値の範囲です。
TemporalFieldのすべてのインスタンスには、有効な値の範囲があります。たとえば、ISO暦の「月の日」は1から始まり、28と31の間のいずれかで終わります。このクラスはその有効な範囲を保持します。
このクラスの制限に注意することが重要です。最大値と最小値だけが提供されます。外側の範囲の中に無効な値が存在する可能性があります。たとえば、ある特異なフィールドの有効値が1、2、4、6、7の場合、範囲は1から7までになりますが、値3および5は無効です。
このクラスのインスタンスは、特定のフィールドには関連付けられません。

実装要件:

このクラスは不変でスレッドセーフです。

導入されたバージョン:

1.8

関連項目:

直列化された形式

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`int`	`checkValidIntValue(long value, TemporalField field)`	指定された値が有効で、`int`に収まることを確認します。
`long`	`checkValidValue(long value, TemporalField field)`	指定された値が有効であることを確認します。
`boolean`	`equals(Object obj)`	この範囲がもう一方の範囲と等しいかどうかを確認します。
`long`	`getLargestMinimum()`	フィールドが取り得る最大の最小値を取得します。
`long`	`getMaximum()`	フィールドが取り得る最大値を取得します。
`long`	`getMinimum()`	フィールドが取り得る最小値を取得します。
`long`	`getSmallestMaximum()`	フィールドが取り得る最小の最大値を取得します。
`int`	`hashCode()`	この範囲のハッシュ・コード。
`boolean`	`isFixed()`	値の範囲が固定で完全に既知かどうか。
`boolean`	`isIntValue()`	範囲内のすべての値が`int`に収まるかどうかを確認します。
`boolean`	`isValidIntValue(long value)`	値が有効な範囲内にあり、範囲内のすべての値が`int`に収まることを確認します。
`boolean`	`isValidValue(long value)`	値が有効な範囲内にあるかどうかを確認します。
`static ValueRange`	`of(long min, long max)`	固定の値範囲を取得します。
`static ValueRange`	`of(long min, long maxSmallest, long maxLargest)`	可変の値範囲を取得します。
`static ValueRange`	`of(long minSmallest, long minLargest, long maxSmallest, long maxLargest)`	完全に可変の値範囲を取得します。
`String`	`toString()`	この範囲を`String`として出力します。

クラス java.lang.Objectから継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- メソッドの詳細
  - of
```
public static ValueRange of(long min,
                            long max)
```
    固定の値範囲を取得します。
    このファクトリは、最小値と最大値が固定の範囲を取得します。たとえば、ISO暦の月の範囲は常に1から12までです。
    
    パラメータ:
    
    min - 最小値
    
    max - 最大値
    
    戻り値:
    
    最小値、最大値に対応するValueRange。null以外
    
    例外:
    
    IllegalArgumentException - 最小値が最大値より大きい場合
  - of
```
public static ValueRange of(long min,
                            long maxSmallest,
                            long maxLargest)
```
    可変の値範囲を取得します。
    このファクトリは、最小値が固定で最大値が可変の範囲を取得します。たとえば、ISO暦の「月の日」は常に1から始まりますが、28と31の間で終わります。
    
    パラメータ:
    
    min - 最小値
    
    maxSmallest - 最小の最大値
    
    maxLargest - 最大の最大値
    
    戻り値:
    
    最小値、最小の最大値、最大の最大値に対応するValueRange。null以外
    
    例外:
    
    IllegalArgumentException - 最小値が最小の最大値より大きいか、最小の最大値が最大の最大値より大きい場合
  - of
```
public static ValueRange of(long minSmallest,
                            long minLargest,
                            long maxSmallest,
                            long maxLargest)
```
    完全に可変の値範囲を取得します。
    このファクトリは、最小値と最大値の両方が可変の範囲を取得します。
    
    パラメータ:
    
    minSmallest - 最小の最小値
    
    minLargest - 最大の最小値
    
    maxSmallest - 最小の最大値
    
    maxLargest - 最大の最大値
    
    戻り値:
    
    最小の最小値、最大の最小値、最小の最大値、最大の最大値に対応するValueRange。null以外
    
    例外:
    
    IllegalArgumentException - 最小の最小値が最小の最大値より大きいか、最小の最大値が最大の最大値より大きいか、最大の最小値が最大の最大値より大きい場合
  - isFixed
```
public boolean isFixed()
```
    値の範囲が固定で完全に既知かどうか。
    たとえば、ISO暦の「月の日」は1から始まり、28と31の間で終わります。最大値が不明確なので、範囲は固定ではありません。ただし、1月の場合、範囲は常に1から31までなので、範囲は固定です。
    
    戻り値:
    
    値のセットが固定の場合はtrue
  - getMinimum
```
public long getMinimum()
```
    フィールドが取り得る最小値を取得します。
    たとえば、ISO暦の「月の日」は常に1から始まります。したがって、最小値は1です。
    
    戻り値:
    
    このフィールドの最小値
  - getLargestMinimum
```
public long getLargestMinimum()
```
    フィールドが取り得る最大の最小値を取得します。
    たとえば、ISO暦の「月の日」は常に1から始まります。したがって、最大の最小値は1です。
    
    戻り値:
    
    このフィールドが取り得る最大の最小値
  - getSmallestMaximum
```
public long getSmallestMaximum()
```
    フィールドが取り得る最小の最大値を取得します。
    たとえば、ISO暦の「月の日」は28と31の間で終わります。したがって、最小の最大値は28です。
    
    戻り値:
    
    このフィールドが取り得る最小の最大値
  - getMaximum
```
public long getMaximum()
```
    フィールドが取り得る最大値を取得します。
    たとえば、ISO暦の「月の日」は28と31の間で終わります。したがって、最大値は31です。
    
    戻り値:
    
    このフィールドの最大値
  - isIntValue
```
public boolean isIntValue()
```
    範囲内のすべての値がintに収まるかどうかを確認します。
    すべての有効値がintの境界に収まるかどうかを確認します。
    たとえば、ISO暦の月の値は1から12までで、これはintに収まります。これに対し、ISO暦の「1日のうちのナノ秒」は1から86,400,000,000,000までで、これはintに収まりません。
    この実装は、getMinimum()とgetMaximum()を使用します。
    
    戻り値:
    
    有効な値が常にintに収まる場合はtrue
  - isValidValue
```
public boolean isValidValue(long value)
```
    値が有効な範囲内にあるかどうかを確認します。
    値が保存された値の範囲内にあるかどうかを確認します。
    
    パラメータ:
    
    value - チェックする値
    
    戻り値:
    
    値が有効な場合はtrue
  - isValidIntValue
```
public boolean isValidIntValue(long value)
```
    値が有効な範囲内にあり、範囲内のすべての値がintに収まることを確認します。
    このメソッドはisIntValue()とisValidValue(long)を組み合せます。
    
    パラメータ:
    
    value - チェックする値
    
    戻り値:
    
    値が有効でintに収まる場合はtrue
  - checkValidValue
```
public long checkValidValue(long value,
                            TemporalField field)
```
    指定された値が有効であることを確認します。
    値が有効な範囲内にあることを検証します。このフィールドはエラー・メッセージを向上させるためだけに使用されます。
    
    パラメータ:
    
    value - チェックする値
    
    field - チェック対象のフィールド。nullの場合もあり
    
    戻り値:
    
    渡された値
    
    関連項目:
    
    isValidValue(long)
  - checkValidIntValue
```
public int checkValidIntValue(long value,
                              TemporalField field)
```
    指定された値が有効で、intに収まることを確認します。
    値が有効な範囲内にあり、すべての有効値がintの境界に収まることを検証します。このフィールドはエラー・メッセージを向上させるためだけに使用されます。
    
    パラメータ:
    
    value - チェックする値
    
    field - チェック対象のフィールド。nullの場合もあり
    
    戻り値:
    
    渡された値
    
    関連項目:
    
    isValidIntValue(long)
  - equals
```
public boolean equals(Object obj)
```
    この範囲がもう一方の範囲と等しいかどうかを確認します。
    比較は4つの値(最小値、最大の最小値、最小の最大値、最大値)に基づいて行われます。 ValueRange型のオブジェクトのみが比較され、それ以外の型ではfalseが返されます。
    
    オーバーライド:
    
    equals、クラスObject
    
    パラメータ:
    
    obj - チェックするオブジェクト、nullはfalseを返す
    
    戻り値:
    
    これがもう一方の範囲と等しい場合はtrue
    
    関連項目:
    
    Object.hashCode()、HashMap
  - hashCode
```
public int hashCode()
```
    この範囲のハッシュ・コード。
    
    オーバーライド:
    
    hashCode、クラスObject
    
    戻り値:
    
    適切なハッシュ・コード
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    この範囲をStringとして出力します。
    フォーマットは「{min}/{largestMin} - {smallestMax}/{max}」となります。ここで、largestMinまたはsmallestMaxのセクションは、minまたはmaxと同じであれば、関連するスラッシュとともに省略できます。
    
    オーバーライド:
    
    toString、クラスObject
    
    戻り値:
    
    この範囲の文字列表現。null以外

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスValueRange

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

メソッドの詳細

of

of

of

isFixed

getMinimum

getLargestMinimum

getSmallestMaximum

getMaximum

isIntValue

isValidValue

isValidIntValue

checkValidValue

checkValidIntValue

equals

hashCode

toString