public class Duration extends Object implements Comparable<Duration>, Serializable
期間を定義するクラス。Durationインスタンスは不変なため、BigDecimal
と同じように変更ではなく置換されます。期間は、コンストラクタまたはseconds(double)
やminutes(double)
などのstatic作成メソッドのいずれかを使用して作成できます。
修飾子と型 | フィールドと説明 |
---|---|
static Duration |
INDEFINITE
無限の期間。
|
static Duration |
ONE
1ミリ秒の期間。
|
static Duration |
UNKNOWN
時間の長さが不明な期間。
|
static Duration |
ZERO
0の期間(時間なし)。
|
コンストラクタと説明 |
---|
Duration(double millis)
潜在的に小数のミリ秒単位の解像度を使用した新しい期間を作成します。
|
修飾子と型 | メソッドと説明 |
---|---|
Duration |
add(Duration other)
このインスタンスと別のDurationインスタンスを加算して、新しいDurationインスタンスを返します。
|
int |
compareTo(Duration d)
このオブジェクトで表される期間と指定されたオブジェクトで表される期間を比較します。
|
Duration |
divide(double n)
このインスタンスを数値で除算し、新しいDurationインスタンスを返します。
|
Duration |
divide(Duration other)
非推奨。
このメソッドでは単位が考慮されないため、予期しない結果が生成されます。かわりに
divide(double) を使用してください。 |
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)
非推奨。
このメソッドでは単位が考慮されないため、予期しない結果が生成されます。かわりに
multiply(double) を使用します。 |
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インスタンスを返すファクトリ・メソッド。
|
public static final Duration ZERO
public static final Duration ONE
public static final Duration INDEFINITE
public static final Duration UNKNOWN
public Duration(double millis)
millis
- ミリ秒数public static Duration valueOf(String time)
time
- 正しくフォーマットされたnull以外の文字列。先頭または後続の空白は正しく解析されません。時間がnullの場合、NullPointerExceptionがスローされます。time
によって表される期間public static Duration millis(double ms)
ms
- ミリ秒数public static Duration seconds(double s)
s
- 秒数public static Duration minutes(double m)
m
- 分数public static Duration hours(double h)
h
- 時間数public double toMillis()
public double toSeconds()
public double toMinutes()
public double toHours()
public Duration add(Duration other)
other
- nullにはできませんpublic Duration subtract(Duration other)
other
- nullにはできません@Deprecated public Duration multiply(Duration other)
multiply(double)
を使用します。other
- nullにはできませんpublic Duration multiply(double n)
n
- 小数のミリ秒単位での、乗算に使用する数値public Duration divide(double n)
n
- 小数のミリ秒単位での、除算に使用する数値@Deprecated public Duration divide(Duration other)
divide(double)
を使用してください。other
- nullにはできませんpublic Duration negate()
Duration.millis(50).negate()
は-50ミリ秒の期間を返します。呼び出されたDurationインスタンスがINDEFINITEの場合、INDEFINITEを返します。この関数では、呼び出されたDurationインスタンスの値は変更されません。public boolean isIndefinite()
public boolean isUnknown()
public boolean lessThan(Duration other)
other
- nullにはできませんpublic boolean lessThanOrEqualTo(Duration other)
other
- nullにはできませんpublic boolean greaterThan(Duration other)
other
- nullにはできませんpublic boolean greaterThanOrEqualTo(Duration other)
other
- nullにはできませんpublic String toString()
Duration
オブジェクトの文字列表現を返します。public int compareTo(Duration d)
compareTo
、インタフェース: Comparable<Duration>
d
- 比較対象の期間。public boolean equals(Object obj)
Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.