- java.lang.Object
-
- javafx.util.Duration
-
- すべての実装されたインタフェース:
Serializable
,Comparable<Duration>
public class Duration extends Object implements Comparable<Duration>, Serializable
期間を定義するクラス。 Durationインスタンスは不変なため、
BigDecimal
と同じように変更ではなく置換されます。 期間は、コンストラクタまたはseconds(double)
やminutes(double)
などのstatic作成メソッドのいずれかを使用して作成できます。- 導入されたバージョン:
- JavaFX 2.0
- 関連項目:
- 直列化された形式
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 Duration(double millis)
潜在的に小数のミリ秒単位の解像度を使用した新しい期間を作成します。
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 具象メソッド 非推奨のメソッド 修飾子と型 メソッド 説明 Duration
add(Duration other)
このインスタンスと別のDurationインスタンスを加算して、新しいDurationインスタンスを返します。int
compareTo(Duration d)
このオブジェクトで表される期間と指定されたオブジェクトで表される期間を比較します。Duration
divide(double n)
このインスタンスを数値で除算し、新しいDurationインスタンスを返します。Duration
divide(Duration other)
非推奨。このメソッドでは単位が考慮されないため、予期しない結果が生成されます。boolean
equals(Object obj)
このオブジェクトと他のオブジェクトが等しいかどうかを示します。boolean
greaterThan(Duration other)
指定された期間がこのインスタンスを上回る(>)場合にはtrueを返します。boolean
greaterThanOrEqualTo(Duration other)
指定された期間がこのインスタンス以上(>=)の場合にはtrueを返します。int
hashCode()
このDuration
オブジェクトのハッシュ・コードを返します。static Duration
hours(double h)
指定された時間数を表すDurationインスタンスを返すファクトリ・メソッド。boolean
isIndefinite()
このDurationインスタンスが無限であるかどうかを取得します。boolean
isUnknown()
このDurationインスタンスが不明であるかどうかを取得します。boolean
lessThan(Duration other)
指定された期間がこのインスタンスを下回る(<)場合にはtrueを返します。boolean
lessThanOrEqualTo(Duration other)
指定された期間がこのインスタンス以下(<=)の場合にはtrueを返します。static Duration
millis(double ms)
指定されたミリ秒数のDurationインスタンスを返すファクトリ・メソッド。static Duration
minutes(double m)
指定された分数を表すDurationインスタンスを返すファクトリ・メソッド。Duration
multiply(double n)
このインスタンスをミリ秒を表す数値で乗算し、新しいDurationを返します。Duration
multiply(Duration other)
非推奨。このメソッドでは単位が考慮されないため、予期しない結果が生成されます。Duration
negate()
このインスタンスからの負のミリ秒数を含む新しいDurationインスタンスを返します。static Duration
seconds(double s)
指定された秒数を表すDurationインスタンスを返すファクトリ・メソッド。Duration
subtract(Duration other)
このインスタンスから他のDurationインスタンスを減算して、新しいDurationインスタンスを返します。double
toHours()
この期間内の時間数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。double
toMillis()
この期間内のミリ秒数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。double
toMinutes()
この期間内の分数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。double
toSeconds()
この期間内の秒数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。String
toString()
このDuration
オブジェクトの文字列表現を返します。static Duration
valueOf(String time)
指定された時間のDurationインスタンスを返すファクトリ・メソッド。
-
-
-
メソッドの詳細
-
valueOf
public static Duration valueOf(String time)
指定された時間のDurationインスタンスを返すファクトリ・メソッド。 構文は"[number][ms|s|m|h]"です。- パラメータ:
time
- 正しくフォーマットされたnull以外の文字列。 先頭または後続の空白は正しく解析されません。 時間がnullの場合、NullPointerExceptionがスローされます。- 戻り値:
time
によって表される期間
-
millis
public static Duration millis(double ms)
指定されたミリ秒数のDurationインスタンスを返すファクトリ・メソッド。- パラメータ:
ms
- ミリ秒数- 戻り値:
- 指定されたミリ秒数のDurationインスタンス
-
seconds
public static Duration seconds(double s)
指定された秒数を表すDurationインスタンスを返すファクトリ・メソッド。- パラメータ:
s
- 秒数- 戻り値:
- 指定された秒数のDurationインスタンス
-
minutes
public static Duration minutes(double m)
指定された分数を表すDurationインスタンスを返すファクトリ・メソッド。- パラメータ:
m
- 分数- 戻り値:
- 指定された分数のDurationインスタンス
-
hours
public static Duration hours(double h)
指定された時間数を表すDurationインスタンスを返すファクトリ・メソッド。- パラメータ:
h
- 時間数- 戻り値:
- 指定された時間数を表すDurationインスタンス
-
toMillis
public double toMillis()
この期間内のミリ秒数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。- 戻り値:
- 小数のミリ秒単位での期間
-
toSeconds
public double toSeconds()
この期間内の秒数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。- 戻り値:
- 小数の秒単位での期間
-
toMinutes
public double toMinutes()
この期間内の分数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。- 戻り値:
- 小数の分単位での期間
-
toHours
public double toHours()
この期間内の時間数を返すか、期間がINDEFINITEの場合にはDouble.POSITIVE_INFINITY、または期間がUNKNOWNの場合にはNaNを返します。- 戻り値:
- 小数の時間単位での期間
-
add
public Duration add(Duration other)
このインスタンスと別のDurationインスタンスを加算して、新しいDurationインスタンスを返します。 いずれかのインスタンスがINDEFINITEの場合、INDEFINITEを返します。 いずれかのインスタンスがUNKNOWNの場合、UNKNOWNを返します。 このメソッドでは、呼び出されたDurationインスタンスの値は変更されません。- パラメータ:
other
- nullにはできません- 戻り値:
- この期間を他の期間に追加した結果。 倍精度浮動小数点演算を使用したmillis + other.millisと同じです。
-
subtract
public Duration subtract(Duration other)
このインスタンスから他のDurationインスタンスを減算して、新しいDurationインスタンスを返します。 いずれかのインスタンスがUNKNOWNの場合、UNKNOWNを返します。 それ以外の場合、いずれかのインスタンスがINDEFINITEであれば、INDEFINITEを返します。 このメソッドでは、呼び出されたDurationインスタンスの値は変更されません。- パラメータ:
other
- nullにはできません- 戻り値:
- この期間から他の期間を減算した結果。 倍精度浮動小数点演算を使用したmillis - other.millisと同じです。
-
multiply
@Deprecated public Duration multiply(Duration other)
非推奨。このメソッドでは単位が考慮されないため、予期しない結果が生成されます。 かわりにmultiply(double)
を使用します。このインスタンスを数値で乗算し、新しいDurationインスタンスを返します。 いずれかのインスタンスがINDEFINITEの場合、INDEFINITEを返します。 いずれかのDurationインスタンスがUNKNOWNの場合、UNKNOWNを返します。 このメソッドでは、呼び出されたDurationインスタンスの値は変更されません。- パラメータ:
other
- nullにはできません- 戻り値:
- この期間を他の期間で乗算した結果。 倍精度浮動小数点演算を使用したmillis * other.millisと同じです。
-
multiply
public Duration multiply(double n)
このインスタンスをミリ秒を表す数値で乗算し、新しいDurationを返します。 呼び出されたDurationインスタンスがINDEFINITEの場合、INDEFINITEを返します。 呼び出されたDurationインスタンスがUNKNOWNの場合、UNKNOWNを返します。 このメソッドでは、呼び出されたDurationインスタンスの値は変更されません。- パラメータ:
n
- 小数のミリ秒単位での、乗算に使用する数値- 戻り値:
- この期間をnで乗算した結果。 倍精度浮動小数点演算を使用したmillis * nと同じです。
-
divide
public Duration divide(double n)
このインスタンスを数値で除算し、新しいDurationインスタンスを返します。 呼び出されたDurationインスタンスがINDEFINITEの場合、INDEFINITEを返します。 呼び出されたDurationインスタンスがUNKNOWNの場合、UNKNOWNを返します。 このメソッドでは、呼び出されたDurationインスタンスの値は変更されません。- パラメータ:
n
- 小数のミリ秒単位での、除算に使用する数値- 戻り値:
- この期間をnで除算した結果。 倍精度浮動小数点演算を使用したmillis / nと同じです。
-
divide
@Deprecated public Duration divide(Duration other)
非推奨。このメソッドでは単位が考慮されないため、予期しない結果が生成されます。 かわりにdivide(double)
を使用してください。このインスタンスを別のDurationで除算し、比率を返します。 両方のインスタンスがINDEFINITEの場合、NaNを返します。 このインスタンスがINDEFINITEの場合にはPOSITIVE_INFINITYを返し、もう一方のインスタンスがINDEFINITEの場合には0.0を返します。 この関数では、呼び出されたDurationインスタンスの値は変更されません。- パラメータ:
other
- nullにはできません- 戻り値:
- この期間を他の期間で除算した結果。 倍精度浮動小数点演算を使用したmillis / other.millisと同じです。
-
negate
public Duration negate()
このインスタンスからの負のミリ秒数を含む新しいDurationインスタンスを返します。 たとえば、Duration.millis(50).negate()
は-50ミリ秒の期間を返します。 呼び出されたDurationインスタンスがINDEFINITEの場合、INDEFINITEを返します。 この関数では、呼び出されたDurationインスタンスの値は変更されません。- 戻り値:
- この期間を否定した結果。 倍精度浮動小数点演算を使用した-millisと同じです。
-
isIndefinite
public boolean isIndefinite()
このDurationインスタンスが無限であるかどうかを取得します。 期間は、Duration.INDEFINITEと同等の場合には無限となります。- 戻り値:
- この期間がDuration.INDEFINITEまたはDouble.POSITIVE_INFINITYと同等の場合、true。
-
isUnknown
public boolean isUnknown()
このDurationインスタンスが不明であるかどうかを取得します。 期間は、Duration.UNKNOWNと同等の場合には不明となります。- 戻り値:
- この期間がDuration.UNKNOWNまたはDouble.isNaN(millis)と同等の場合、true
-
lessThan
public boolean lessThan(Duration other)
指定された期間がこのインスタンスを下回る(<)場合にはtrueを返します。 INDEFINITEは、正の無限大としてみなされます。- パラメータ:
other
- nullにはできません- 戻り値:
- 倍精度演算を使用するmillis < other.millisの場合はtrue
-
lessThanOrEqualTo
public boolean lessThanOrEqualTo(Duration other)
指定された期間がこのインスタンス以下(<=)の場合にはtrueを返します。 INDEFINITEは、正の無限大としてみなされます。- パラメータ:
other
- nullにはできません- 戻り値:
- 倍精度演算を使用するmillis <= other.millisの場合はtrue
-
greaterThan
public boolean greaterThan(Duration other)
指定された期間がこのインスタンスを上回る(>)場合にはtrueを返します。 INDEFINITEは、正の無限大としてみなされます。- パラメータ:
other
- nullにはできません- 戻り値:
- 倍精度浮動小数点演算を使用して、millis > other.millisとなる場合にはtrue
-
greaterThanOrEqualTo
public boolean greaterThanOrEqualTo(Duration other)
指定された期間がこのインスタンス以上(>=)の場合にはtrueを返します。 INDEFINITEは、正の無限大としてみなされます。- パラメータ:
other
- nullにはできません- 戻り値:
- 倍精度浮動小数点演算を使用して、millis >= other.millisとなる場合にはtrue
-
toString
public String toString()
このDuration
オブジェクトの文字列表現を返します。
-
compareTo
public int compareTo(Duration d)
このオブジェクトで表される期間と指定されたオブジェクトで表される期間を比較します。 この期間が指定された期間を下回る場合は負の整数、等しい場合はゼロ、上回る場合は正の整数を返します。- 定義:
compareTo
、インタフェース:Comparable<Duration>
- パラメータ:
d
- 比較対象の期間。- 戻り値:
- この期間が指定された期間を下回る場合は負の整数、等しい場合はゼロ、上回る場合は正の整数。
-
equals
public boolean equals(Object obj)
このオブジェクトと他のオブジェクトが等しいかどうかを示します。- オーバーライド:
equals
、クラス:Object
- パラメータ:
obj
- 比較対象の参照オブジェクト。- 戻り値:
- このオブジェクトが
obj
引数と同じである場合はtrue
、それ以外の場合はfalse
。 - 関連項目:
Object.hashCode()
、HashMap
-
hashCode
public int hashCode()
このDuration
オブジェクトのハッシュ・コードを返します。- オーバーライド:
hashCode
、クラス:Object
- 戻り値:
- この
Duration
オブジェクトのハッシュ・コード。 - 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-