public final class OffsetTime extends Object implements Temporal, TemporalAdjuster, Comparable<OffsetTime>, Serializable
10:15:30+01:00
など)。
OffsetTime
は、時間(時-分-秒-オフセットとして表示されることが多い)を表す不変の日付/時間オブジェクトです。このクラスでは、ゾーンオフセットの他に、すべての時間フィールドをナノ秒の精度まで格納します。たとえば、「13:45.30.123456789+02:00」という値をOffsetTime
に格納できます。
これは値ベースのクラスです。OffsetTime
のインスタンスに対して、アイデンティティの影響を受けやすい操作(参照型等価演算子(==
)、アイデンティティ・ハッシュ・コード、同期化など)を使用すると、予測できない結果が生じることがあるため、使わないようにしてください。比較する場合は、equals
メソッドを使用することをお薦めします。
修飾子と型 | フィールドと説明 |
---|---|
static OffsetTime |
MAX
サポートされている最大の
OffsetTime である「23:59:59.999999999-18:00」。 |
static OffsetTime |
MIN
サポートされている最小の
OffsetTime である「00:00:00+18:00」。 |
修飾子と型 | メソッドと説明 |
---|---|
Temporal |
adjustInto(Temporal temporal)
指定された時間的オブジェクトを、このオブジェクトと同じオフセットおよび時間を持つように調整します。
|
OffsetDateTime |
atDate(LocalDate date)
この時間を日付と組み合せて
OffsetDateTime を作成します。 |
int |
compareTo(OffsetTime other)
この
OffsetTime をもう一方の時間と比較します。 |
boolean |
equals(Object obj)
この時間がもう一方の時間と等しいかどうかを確認します。
|
String |
format(DateTimeFormatter formatter)
指定されたフォーマッタを使用してこの時間を書式設定します。
|
static OffsetTime |
from(TemporalAccessor temporal)
時間的オブジェクトから
OffsetTime のインスタンスを取得します。 |
int |
get(TemporalField field)
指定されたフィールドの値をこの時間から
int として取得します。 |
int |
getHour()
時フィールドを取得します。
|
long |
getLong(TemporalField field)
指定されたフィールドの値をこの時間から
long として取得します。 |
int |
getMinute()
分フィールドを取得します。
|
int |
getNano()
ナノ秒フィールドを取得します。
|
ZoneOffset |
getOffset()
「+01:00」などのゾーン・オフセットを取得します。
|
int |
getSecond()
秒フィールドを取得します。
|
int |
hashCode()
この時間のハッシュ・コード。
|
boolean |
isAfter(OffsetTime other)
両方の時間を一般的な日付に当てはめて、この
OffsetTime のインスタントが指定された時間のそれより後にあるかどうかを確認します。 |
boolean |
isBefore(OffsetTime other)
両方の時間を一般的な日付に当てはめて、この
OffsetTime のインスタントが指定された時間のそれより前にあるかどうかを確認します。 |
boolean |
isEqual(OffsetTime other)
両方の時間を一般的な日付に当てはめて、この
OffsetTime のインスタントが指定された時間のそれと等しいかどうかを確認します。 |
boolean |
isSupported(TemporalField field)
指定されたフィールドがサポートされているかどうかをチェックします。
|
boolean |
isSupported(TemporalUnit unit)
指定された単位がサポートされているかどうかをチェックします。
|
OffsetTime |
minus(long amountToSubtract, TemporalUnit unit)
指定された量を減算して、この時間のコピーを返します。
|
OffsetTime |
minus(TemporalAmount amountToSubtract)
指定された量を減算して、この時間のコピーを返します。
|
OffsetTime |
minusHours(long hours)
指定された時間数を減算して、この
OffsetTime のコピーを返します。 |
OffsetTime |
minusMinutes(long minutes)
指定された分数を減算して、この
OffsetTime のコピーを返します。 |
OffsetTime |
minusNanos(long nanos)
指定されたナノ秒数を減算して、この
OffsetTime のコピーを返します。 |
OffsetTime |
minusSeconds(long seconds)
指定された秒数を減算して、この
OffsetTime のコピーを返します。 |
static OffsetTime |
now()
デフォルトのタイムゾーンのシステム・クロックから現在の時間を取得します。
|
static OffsetTime |
now(Clock clock)
指定されたクロックから現在の時間を取得します。
|
static OffsetTime |
now(ZoneId zone)
指定されたタイムゾーンのシステム・クロックから現在の時間を取得します。
|
static OffsetTime |
of(int hour, int minute, int second, int nanoOfSecond, ZoneOffset offset)
時、分、秒、およびナノ秒から
OffsetTime のインスタンスを取得します。 |
static OffsetTime |
of(LocalTime time, ZoneOffset offset)
ローカル時間およびオフセットから
OffsetTime のインスタンスを取得します。 |
static OffsetTime |
ofInstant(Instant instant, ZoneId zone)
Instant およびゾーンIDからOffsetTime のインスタンスを取得します。 |
static OffsetTime |
parse(CharSequence text)
テキスト文字列(
10:15:30+01:00 など)からOffsetTime のインスタンスを取得します。 |
static OffsetTime |
parse(CharSequence text, DateTimeFormatter formatter)
特定のフォーマッタを使用して、テキスト文字列から
OffsetTime のインスタンスを取得します。 |
OffsetTime |
plus(long amountToAdd, TemporalUnit unit)
この時刻のコピーに指定された時間を追加したものを返します。
|
OffsetTime |
plus(TemporalAmount amountToAdd)
この時刻のコピーに指定された時間を追加したものを返します。
|
OffsetTime |
plusHours(long hours)
指定された時間数を加算して、この
OffsetTime のコピーを返します。 |
OffsetTime |
plusMinutes(long minutes)
指定された分数を加算して、この
OffsetTime のコピーを返します。 |
OffsetTime |
plusNanos(long nanos)
指定されたナノ秒数を加算して、この
OffsetTime のコピーを返します。 |
OffsetTime |
plusSeconds(long seconds)
指定された秒数を加算して、この
OffsetTime のコピーを返します。 |
<R> R |
query(TemporalQuery<R> query)
指定された問合せを使用してこの時間を問い合せます。
|
ValueRange |
range(TemporalField field)
指定されたフィールドの有効な値の範囲を取得します。
|
LocalTime |
toLocalTime()
この日付/時間の
LocalTime 部分を取得します。 |
String |
toString()
この時間を
String として出力します(10:15:30+01:00 など)。 |
OffsetTime |
truncatedTo(TemporalUnit unit)
時間を切り捨てて、この
OffsetTime のコピーを返します。 |
long |
until(Temporal endExclusive, TemporalUnit unit)
もう一方の時間までの時間量を指定された単位で計算します。
|
OffsetTime |
with(TemporalAdjuster adjuster)
この時間の調整済のコピーを返します。
|
OffsetTime |
with(TemporalField field, long newValue)
指定されたフィールドを新しい値に設定して、この時間のコピーを返します。
|
OffsetTime |
withHour(int hour)
時の値を変更して、この
OffsetTime のコピーを返します。 |
OffsetTime |
withMinute(int minute)
分の値を変更して、この
OffsetTime のコピーを返します。 |
OffsetTime |
withNano(int nanoOfSecond)
ナノ秒の値を変更して、この
OffsetTime のコピーを返します。 |
OffsetTime |
withOffsetSameInstant(ZoneOffset offset)
結果が暗黙の日の同じインスタントを持つようにしながら、指定されたオフセットを使ってこの
OffsetTime のコピーを返します。 |
OffsetTime |
withOffsetSameLocal(ZoneOffset offset)
結果が同じローカル時間を持つようにしながら、指定されたオフセットを使ってこの
OffsetTime のコピーを返します。 |
OffsetTime |
withSecond(int second)
秒の値を変更して、この
OffsetTime のコピーを返します。 |
public static final OffsetTime MIN
OffsetTime
である「00:00:00+18:00」。これは、最大オフセット(オフセットが大きくなるほど、時系列上では早くなる)でのその日の開始時の午前零時の時間です。これは、LocalTime.MIN
とZoneOffset.MAX
を組み合せます。これは、アプリケーションによって「遠い過去」の日付として使用されることがあります。public static final OffsetTime MAX
OffsetTime
である「23:59:59.999999999-18:00」。これは、最小オフセット(負のオフセットが大きくなるほど、時系列上では遅くなる)でのその日の終わりの午前零時直前の時間です。これは、LocalTime.MAX
とZoneOffset.MIN
を組み合せます。これは、アプリケーションによって「遠い将来」の日付として使用されることがあります。public static OffsetTime now()
これは、デフォルトのタイムゾーンのシステム・クロック
を問い合せて、現在の時間を取得します。オフセットは、そのクロックのタイムゾーンから計算されます。
このメソッドを使用すると、クロックがハードコードされているため、テストに代替のクロックを使用できないようにします。
public static OffsetTime now(ZoneId zone)
これは、システム・クロック
を問い合せて現在の時間を取得します。タイムゾーンを指定すると、デフォルトのタイムゾーンへの依存を避けられます。オフセットは、指定されたタイムゾーンから計算されます。
このメソッドを使用すると、クロックがハードコードされているため、テストに代替のクロックを使用できないようにします。
zone
- 使用するゾーンID、null以外public static OffsetTime now(Clock clock)
これは、指定されたクロックを照会して現在の時間を取得します。オフセットは、そのクロックのタイムゾーンから計算されます。
このメソッドを使用すると、テストに代替のクロックを使用できます。代替のクロックはdependency injection
を使用して導入できます。
clock
- 使用するクロック、null以外public static OffsetTime of(LocalTime time, ZoneOffset offset)
OffsetTime
のインスタンスを取得します。time
- ローカル時間。null以外offset
- ゾーンオフセット。null以外public static OffsetTime of(int hour, int minute, int second, int nanoOfSecond, ZoneOffset offset)
OffsetTime
のインスタンスを取得します。
これは、4つの指定されたフィールドを使用してオフセット時間を作成します。
このメソッドは、主としてテスト・ケースを作成するために存在しています。テスト・コード以外では通常、別のメソッドを使ってオフセット時間を作成します。LocalTime
には、より少ない引数を取る、同等のファクトリ・メソッドの簡易バリアントが他に2つあります。APIのサイズを減らすため、それらについてはここでは説明しません。
hour
- 表される時(0-23)minute
- 表される分(0-59)second
- 表される秒(0-59)nanoOfSecond
- 表現する「1秒のうちのナノ秒」、0から999,999,999offset
- ゾーンオフセット。null以外DateTimeException
- いずれかのフィールドの値が範囲外にある場合public static OffsetTime ofInstant(Instant instant, ZoneId zone)
Instant
およびゾーンIDからOffsetTime
のインスタンスを取得します。
これは、指定されたのと同じインスタントを使ってオフセット時間を作成します。インスタントごとに有効なオフセットは1つしかないため、UTC/グリニッジからのオフセットを見つけるのは簡単です。
そのインスタントの日付コンポーネントは、変換中に削除されます。これは、そのインスタントが有効な日付の範囲外にあるために変換に失敗する可能性がないことを意味します。
instant
- 時間の作成元のインスタント。null以外zone
- タイムゾーン。オフセットの場合もある。null以外public static OffsetTime from(TemporalAccessor temporal)
OffsetTime
のインスタンスを取得します。
これは、指定された時間に基づいてオフセット時間を取得します。TemporalAccessor
は任意の日付と時間のセットに関する情報を表し、それがこのファクトリでOffsetTime
のインスタンスに変換されます。
この変換では、時間的オブジェクトからZoneOffset
およびLocalTime
を抽出して組み合せます。実装では、関連オブジェクトと同等のそれらのフィールドにアクセスするなどの最適化を実行することが許可されます。
このメソッドは、関数型インタフェースTemporalQuery
のシグネチャに一致するため、メソッド参照OffsetTime::from
を介して問合せで使用できます。
temporal
- 変換する一時オブジェクト、null以外DateTimeException
- OffsetTime
に変換できない場合public static OffsetTime parse(CharSequence text)
10:15:30+01:00
など)からOffsetTime
のインスタンスを取得します。
この文字列は有効な時間を表している必要があり、DateTimeFormatter.ISO_OFFSET_TIME
を使って解析されます。
text
- 「10:15:30+01:00」などの解析対象のテキスト。null以外DateTimeParseException
- テキストが解析できない場合public static OffsetTime parse(CharSequence text, DateTimeFormatter formatter)
OffsetTime
のインスタンスを取得します。
そのテキストがフォーマッタを使って解析され、時間が返されます。
text
- 解析するテキスト。null以外formatter
- 使用するフォーマッタ、null以外DateTimeParseException
- テキストが解析できない場合public boolean isSupported(TemporalField field)
これは、指定されたフィールドをこの時間に問い合せることができるかどうかを確認します。falseの場合、range
、get
、およびwith(TemporalField, long)
メソッドの呼び出しは、例外をスローします。
フィールドがChronoField
の場合、ここに問合せを実装します。サポートされるフィールドは次のとおりです。
NANO_OF_SECOND
NANO_OF_DAY
MICRO_OF_SECOND
MICRO_OF_DAY
MILLI_OF_SECOND
MILLI_OF_DAY
SECOND_OF_MINUTE
SECOND_OF_DAY
MINUTE_OF_HOUR
MINUTE_OF_DAY
HOUR_OF_AMPM
CLOCK_HOUR_OF_AMPM
HOUR_OF_DAY
CLOCK_HOUR_OF_DAY
AMPM_OF_DAY
OFFSET_SECONDS
ChronoField
インスタンスはfalseを返します。
フィールドがChronoField
でない場合、このメソッドの結果は、this
を引数として渡してTemporalField.isSupportedBy(TemporalAccessor)
を呼び出すことによって取得します。フィールドがサポートされているかどうかはフィールドによって決定します。
TemporalAccessor
のisSupported
field
- チェックするフィールド、nullはfalseを返すpublic boolean isSupported(TemporalUnit unit)
これは、指定された単位をこの日付/時間に対して加算または減算できるかどうかをチェックします。falseの場合、plus(long, TemporalUnit)
およびminus
メソッドの呼び出しは、例外をスローします。
単位がChronoUnit
の場合、問合せはここで実装されます。サポートされる単位は次のとおりです。
NANOS
MICROS
MILLIS
SECONDS
MINUTES
HOURS
HALF_DAYS
ChronoUnit
インスタンスはfalseを返します。
単位がChronoUnit
でない場合、このメソッドの結果は、this
を引数として渡してTemporalUnit.isSupportedBy(Temporal)
を呼び出すことによって取得します。単位がサポートされているかどうかは単位によって決定します。
Temporal
のisSupported
unit
- チェックする単位、nullはfalseを返すpublic ValueRange range(TemporalField field)
範囲オブジェクトはフィールドの有効な最小値と最大値を表します。この時間は、返される範囲の精度を高めるために使用されます。範囲を返せない場合は、フィールドがサポートされていないか他のなんらかの理由で、例外がスローされます。
フィールドがChronoField
の場合、ここに問合せを実装します。サポートされるフィールド
は適切な範囲のインスタンスを返します。他のすべてのChronoField
インスタンスはUnsupportedTemporalTypeException
をスローします。
フィールドがChronoField
ではない場合、このメソッドの結果は、引数としてthis
を渡してTemporalField.rangeRefinedBy(TemporalAccessor)
を呼び出すことにより取得されます。範囲を取得できるかどうかはフィールドによって決まります。
TemporalAccessor
のrange
field
- 範囲を問い合わせるフィールド、null以外DateTimeException
- フィールドの範囲を取得できない場合UnsupportedTemporalTypeException
- フィールドがサポートされていない場合public int get(TemporalField field)
int
として取得します。
これは、指定されたフィールドの値をこの時間に問い合せます。返される値は常にフィールドの値の有効な範囲内になります。値を返せない場合は、フィールドがサポートされていないか他のなんらかの理由で、例外がスローされます。
フィールドがChronoField
の場合、ここに問合せを実装します。サポートされているフィールド
はこの時間に基づいて有効な値を返します。ただし、NANO_OF_DAY
およびMICRO_OF_DAY
は長すぎてint
に収まらないので、DateTimeException
がスローされます。他のすべてのChronoField
インスタンスはUnsupportedTemporalTypeException
をスローします。
フィールドがChronoField
ではない場合、このメソッドの結果は、引数としてthis
を渡してTemporalField.getFrom(TemporalAccessor)
を呼び出すことにより取得されます。値を取得できるかどうか、および値が何を表すかは、フィールドによって決まります。
TemporalAccessor
のget
field
- 取得するフィールド、null以外DateTimeException
- フィールドの値を取得できない場合、または値がフィールドの有効な値の範囲外の場合UnsupportedTemporalTypeException
- フィールドがサポートされていない場合、または値の範囲がint
を超えている場合ArithmeticException
- 数値のオーバーフローが発生した場合public long getLong(TemporalField field)
long
として取得します。
これは、指定されたフィールドの値をこの時間に問い合せます。値を返せない場合は、フィールドがサポートされていないか他のなんらかの理由で、例外がスローされます。
フィールドがChronoField
の場合、ここに問合せを実装します。サポートされているフィールド
は、この時間に基づいて有効な値を返します。他のすべてのChronoField
インスタンスはUnsupportedTemporalTypeException
をスローします。
フィールドがChronoField
ではない場合、このメソッドの結果は、引数としてthis
を渡してTemporalField.getFrom(TemporalAccessor)
を呼び出すことにより取得されます。値を取得できるかどうか、および値が何を表すかは、フィールドによって決まります。
TemporalAccessor
のgetLong
field
- 取得するフィールド、null以外DateTimeException
- フィールドの値を取得できない場合UnsupportedTemporalTypeException
- フィールドがサポートされていない場合ArithmeticException
- 数値のオーバーフローが発生した場合public ZoneOffset getOffset()
これは、UTC/グリニッジからのローカル時間のオフセットです。
public OffsetTime withOffsetSameLocal(ZoneOffset offset)
OffsetTime
のコピーを返します。
このメソッドは、同じLocalTime
および指定されたZoneOffset
を使ってオブジェクトを返します。必要な計算や行われる計算はありません。たとえば、この時間が10:30+02:00
を表し、指定されたオフセットが+03:00
の場合、このメソッドは10:30+03:00
を返します。
それらのオフセット間の差異を考慮に入れて、時間フィールドを調整するには、withOffsetSameInstant(java.time.ZoneOffset)
を使用します。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
offset
- 変更後のゾーンオフセット。null以外OffsetTime
。null以外public OffsetTime withOffsetSameInstant(ZoneOffset offset)
OffsetTime
のコピーを返します。
このメソッドは、指定されたZoneOffset
およびLocalTime
を2つのオフセット間の差異によって調整してオブジェクトを返します。これによって、暗黙の日の同じインスタントを表す古いオブジェクトと新しいオブジェクトが生成されます。これは、ローカル時間を異なるオフセットで検索する場合に役立ちます。たとえば、この時間が10:30+02:00
を表し、指定されたオフセットが+03:00
の場合、このメソッドは11:30+03:00
を返します。
ローカル時間を調整しないでオフセットを変更するには、withOffsetSameLocal(java.time.ZoneOffset)
を使用します。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
offset
- 変更後のゾーンオフセット。null以外OffsetTime
。null以外public LocalTime toLocalTime()
LocalTime
部分を取得します。
これは、この日付/時間と同じ時、分、秒、およびナノ秒を使ってLocalTime
を返します。
public int getHour()
public int getMinute()
public int getSecond()
public int getNano()
public OffsetTime with(TemporalAdjuster adjuster)
これは、時間を調整して、この時間に基づくOffsetTime
を返します。調整は、指定されたアジャスタ戦略オブジェクトを使用して行われます。どのような調整が行われるかを理解するには、アジャスタのドキュメントを参照してください。
単純なアジャスタは、時フィールドなど、いずれか1つのフィールドを設定できるだけです。より複雑なアジャスタは、時間をその日の最後の時に設定できます。
クラスLocalTime
およびZoneOffset
はTemporalAdjuster
を実装するため、このメソッドを使用すると、時間またはオフセットを変更できます。
result = offsetTime.with(time); result = offsetTime.with(offset);
このメソッドの結果は、指定されたアジャスタでthis
を引数として渡してTemporalAdjuster.adjustInto(Temporal)
メソッドを呼び出すことによって取得されます。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
Temporal
のwith
adjuster
- 使用するアジャスタ、null以外これ
に基づくOffsetTime
。null以外DateTimeException
- 調整ができない場合ArithmeticException
- 数値のオーバーフローが発生した場合public OffsetTime with(TemporalField field, long newValue)
これは、指定されたフィールドの値を変更して、この時間に基づくOffsetTime
を返します。これを使用すると、時、分、秒などのサポートされているフィールドを変更できます。値を設定できない場合は、フィールドがサポートされていないか他の理由のために、例外がスローされます。
フィールドがChronoField
の場合は、調整はここで実装されます。
OFFSET_SECONDS
フィールドは、指定されたオフセットを使って時間を返します。ローカル時間は変更されません。新しいオフセット値が有効な範囲外にある場合は、DateTimeException
がスローされます。
その他のサポートされているフィールド
は、LocalTime.with(TemporalField, long)
LocalTime}上の一致するメソッドのとおりに動作します。この場合、オフセットは計算の一部ではないため、変更されません。
他のすべてのChronoField
インスタンスはUnsupportedTemporalTypeException
をスローします。
フィールドがChronoField
ではない場合、このメソッドの結果は、this
を引数として渡してTemporalField.adjustInto(Temporal, long)
を呼び出すことによって取得されます。この場合、インスタントを調整するかどうかおよびどのように調整するかはフィールドによって決まります。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
Temporal
のwith
field
- 結果に設定するフィールド、null以外newValue
- 結果のフィールドの新しい値これ
に基づくOffsetTime
。null以外DateTimeException
- フィールドを設定できない場合UnsupportedTemporalTypeException
- フィールドがサポートされていない場合ArithmeticException
- 数値のオーバーフローが発生した場合public OffsetTime withHour(int hour)
OffsetTime
のコピーを返します。
オフセットは計算に影響を及ぼさないため、結果でも同じになります。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
hour
- 結果に設定される時(0-23)OffsetTime
。null以外DateTimeException
- 時の値が無効である場合public OffsetTime withMinute(int minute)
OffsetTime
のコピーを返します。
オフセットは計算に影響を及ぼさないため、結果でも同じになります。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
minute
- 結果に設定される分(0-59)OffsetTime
。null以外DateTimeException
- 分の値が無効である場合public OffsetTime withSecond(int second)
OffsetTime
のコピーを返します。
オフセットは計算に影響を及ぼさないため、結果でも同じになります。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
second
- 結果に設定される秒(0-59)OffsetTime
。null以外DateTimeException
- 秒の値が無効である場合public OffsetTime withNano(int nanoOfSecond)
OffsetTime
のコピーを返します。
オフセットは計算に影響を及ぼさないため、結果でも同じになります。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
nanoOfSecond
- 結果に設定されるナノ秒(0-999,999,999)OffsetTime
。null以外DateTimeException
- ナノ秒の値が無効である場合public OffsetTime truncatedTo(TemporalUnit unit)
OffsetTime
のコピーを返します。
切り詰めでは、指定された単位よりも小さいフィールドをゼロに設定して、元の時間のコピーを返します。たとえば、分
単位で切り詰めると、秒およびナノ秒フィールドはゼロに設定されます。
単位は、標準日の長さを余りなしで等分するデュレーションを持つ必要があります。これには、ChronoUnit
とDAYS
で提供されるすべての時間単位が含まれます。他の単位は例外をスローします。
オフセットは計算に影響を及ぼさないため、結果でも同じになります。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
unit
- 切り捨てを行う単位、nullでないOffsetTime
。null以外DateTimeException
- 切り捨てられない場合UnsupportedTemporalTypeException
- 単位がサポートされていない場合public OffsetTime plus(TemporalAmount amountToAdd)
これは、指定された量を加算して、この時間に基づくOffsetTime
を返します。この量は通常Duration
ですが、TemporalAmount
インタフェースを実装する他のどの型であってもかまいません。
計算は、TemporalAmount.addTo(Temporal)
を呼び出すことによって量オブジェクトに委譲されます。量実装は加算を任意の方法で自由に実装できますが、通常はplus(long, TemporalUnit)
にコールバックします。正常に加算できるかどうかを判断するには、量実装のドキュメントを参照してください。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
Temporal
のplus
amountToAdd
- 加算する量、nullでないOffsetTime
。null以外DateTimeException
- 加算できない場合ArithmeticException
- 数値のオーバーフローが発生した場合public OffsetTime plus(long amountToAdd, TemporalUnit unit)
これは、その単位での量を加算して、この時間に基づくOffsetTime
を返します。量を加算できない場合、単位がサポートされていないか他の理由のために、例外がスローされます。
フィールドがChronoUnit
である場合は、LocalTime.plus(long, TemporalUnit)
によって加算が実装されます。オフセットは計算の一部ではないため、結果でも変わりません。
フィールドがChronoUnit
でない場合、このメソッドの結果は、this
を引数として渡してTemporalUnit.addTo(Temporal, long)
を呼び出すことによって取得されます。この場合、加算を実行するかどうかおよびどのように実行するかは単位によって決まります。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
Temporal
のplus
amountToAdd
- 結果に加算する単位の量、負も可unit
- 加算する量の単位、nullでないOffsetTime
。null以外DateTimeException
- 加算できない場合UnsupportedTemporalTypeException
- 単位がサポートされていない場合ArithmeticException
- 数値のオーバーフローが発生した場合public OffsetTime plusHours(long hours)
OffsetTime
のコピーを返します。
これは、指定された時間数をこの時間に加算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
hours
- 加算する時間数。負の値の場合もあるOffsetTime
。null以外public OffsetTime plusMinutes(long minutes)
OffsetTime
のコピーを返します。
これは、指定された分数をこの時間に加算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
minutes
- 加算する分数。負の値の場合もあるOffsetTime
。null以外public OffsetTime plusSeconds(long seconds)
OffsetTime
のコピーを返します。
これは、指定された秒数をこの時間に加算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
seconds
- 加算する秒数。負の値の場合もあるOffsetTime
。null以外public OffsetTime plusNanos(long nanos)
OffsetTime
のコピーを返します。
これは、指定されたナノ秒数をこの時間に加算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
nanos
- 加算するナノ秒数。負の値の場合もあるOffsetTime
。null以外public OffsetTime minus(TemporalAmount amountToSubtract)
これは、指定された量を減算して、この時間に基づくOffsetTime
を返します。この量は通常Duration
ですが、TemporalAmount
インタフェースを実装する他のどの型であってもかまいません。
計算は、TemporalAmount.subtractFrom(Temporal)
を呼び出すことによって量オブジェクトに委譲されます。量実装は減算を任意の方法で自由に実装できますが、通常はminus(long, TemporalUnit)
にコールバックします。正常に減算できるかどうかを判断するには、量実装のドキュメントを参照してしてください。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
Temporal
のminus
amountToSubtract
- 減算する量、nullでないOffsetTime
。null以外DateTimeException
- 減算ができない場合ArithmeticException
- 数値のオーバーフローが発生した場合public OffsetTime minus(long amountToSubtract, TemporalUnit unit)
これは、その単位での量を減算して、この時間に基づくOffsetTime
を返します。量を減算できない場合、単位がサポートされていないか他の理由のために、例外がスローされます。
このメソッドは、量を符号反転したplus(long, TemporalUnit)
と同等です。加算および減算がどのように行われるかについての詳しい説明は、そのメソッドを参照してください。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
Temporal
のminus
amountToSubtract
- 結果から減算する単位の量、負も可unit
- 減算する量の単位、nullでないOffsetTime
。null以外DateTimeException
- 減算ができない場合UnsupportedTemporalTypeException
- 単位がサポートされていない場合ArithmeticException
- 数値のオーバーフローが発生した場合public OffsetTime minusHours(long hours)
OffsetTime
のコピーを返します。
これは、指定された時間数をこの時間から減算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
hours
- 減算する時間数。負の値の場合もあるOffsetTime
。null以外public OffsetTime minusMinutes(long minutes)
OffsetTime
のコピーを返します。
これは、指定された分数をこの時間から減算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
minutes
- 減算する分数。負の値の場合もあるOffsetTime
。null以外public OffsetTime minusSeconds(long seconds)
OffsetTime
のコピーを返します。
これは、指定された秒数をこの時間から減算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
seconds
- 減算する秒数。負の値の場合もあるOffsetTime
。null以外public OffsetTime minusNanos(long nanos)
OffsetTime
のコピーを返します。
これは、指定されたナノ秒数をこの時間から減算して、新しい時間を返します。この計算は深夜零時でラップします。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
nanos
- 減算するナノ秒数。負の値の場合もあるOffsetTime
。null以外public <R> R query(TemporalQuery<R> query)
これは、指定された問合せ方針オブジェクトを使用してこの時間を問い合せます。TemporalQuery
オブジェクトは結果を取得するために使用するロジックを定義します。このメソッドの結果を理解するには、問合せのドキュメントをお読みください。
このメソッドの結果は、this
を引数として渡して、指定した問合せでTemporalQuery.queryFrom(TemporalAccessor)
メソッドを呼び出すことによって取得します。
TemporalAccessor
のquery
R
- 結果の型query
- 呼び出す問合せ、null以外DateTimeException
- 問い合わせできない場合(問合せによって定義される)ArithmeticException
- 数値のオーバーフローが発生した場合(問合せによって定義される)public Temporal adjustInto(Temporal temporal)
これは、オフセットおよび時間をこれと同じになるように変更して、入力と同じ識別可能な型の時間的オブジェクトを返します。
この調整は、ChronoField.NANO_OF_DAY
およびChronoField.OFFSET_SECONDS
をフィールドとして渡してTemporal.with(TemporalField, long)
を2回使用することと同等です。
ほとんどのケースで、Temporal.with(TemporalAdjuster)
を使用して、呼び出しパターンを逆にすると明確になります。
// these two lines are equivalent, but the second approach is recommended temporal = thisOffsetTime.adjustInto(temporal); temporal = temporal.with(thisOffsetTime);
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
TemporalAdjuster
のadjustInto
temporal
- 調整するターゲット・オブジェクト、null以外DateTimeException
- 調整を実行できない場合ArithmeticException
- 数値のオーバーフローが発生した場合public long until(Temporal endExclusive, TemporalUnit unit)
これは、1つのTemporalUnit
を単位として、2つのOffsetTime
オブジェクト間の時間量を計算します。始点と終点は、これ
と指定された時間です。終了が開始より前である場合、結果は負になります。たとえば、2つの時間の間の時間数は、startTime.until(endTime, HOURS)
を使用して計算できます。
このメソッドに渡されたTemporal
は、from(TemporalAccessor)
を使用してOffsetTime
に変換されます。2つの時間の間でオフセットが異なる場合は、指定された終了時間がこの時間と同じオフセットを持つように正規化されます。
この計算では、2つの時間の間の完全な単位の数を表す整数を返します。たとえば、11:30Zと13:29Zの間の時間数は、2時間には1分足りないため、1時間のみとなります。
このメソッドを使用する等価な方法が2つあります。1つ目はこのメソッドを呼び出すことです。2つ目はTemporalUnit.between(Temporal, Temporal)
を使用することです。
// these two lines are equivalent amount = start.until(end, MINUTES); amount = MINUTES.between(start, end);この選択は、コードが読みやすくなるのはどちらかに基づいて行ってください。
計算はChronoUnit
のこのメソッドに実装します。サポートされている単位は、NANOS
、MICROS
、MILLIS
、SECONDS
、MINUTES
、HOURS
、およびHALF_DAYS
です。その他のChronoUnit
値は例外をスローします。
単位がChronoUnit
でない場合、このメソッドの結果は、this
を1つ目の引数として、変換される入力temporal (一時)を2つ目の引数として渡してTemporalUnit.between(Temporal, Temporal)
を呼び出すことによって取得します。
このインスタンスは不変で、このメソッド呼び出しによって影響を受けません。
Temporal
のuntil
endExclusive
- OffsetTime
に変換される終了日付(これを含まない)。null以外unit
- 量を測定する単位、null以外DateTimeException
- その量を計算できないか、終了時間をOffsetTime
に変換できない場合UnsupportedTemporalTypeException
- 単位がサポートされていない場合ArithmeticException
- 数値のオーバーフローが発生した場合public String format(DateTimeFormatter formatter)
この時間がフォーマッタに渡されて、文字列が生成されます。
formatter
- 使用するフォーマッタ、null以外DateTimeException
- 出力時にエラーが発生した場合public OffsetDateTime atDate(LocalDate date)
OffsetDateTime
を作成します。
これは、この時間および指定された日付から形成されたOffsetDateTime
を返します。日付と時間のすべての可能性のある組合わせが有効です。
date
- 組み合せる日付。null以外public int compareTo(OffsetTime other)
OffsetTime
をもう一方の時間と比較します。
この比較は、まずUTCに相当するインスタントに基づいて行われ、次にローカル時間に基づいて行われます。Comparable
に定義されているとおりに、「equalsと一致」しています。
たとえば、以下はコンパレータの順序です。
10:30+01:00
11:00+01:00
12:00+02:00
11:30+01:00
12:00+01:00
12:30+01:00
equals()
と矛盾しないようにするために必要です。
2つのTemporalAccessor
インスタンスのベースとなるローカル時間を比較するには、ChronoField.NANO_OF_DAY
をコンパレータとして使用します。
compareTo
、インタフェース: Comparable<OffsetTime>
other
- 比較対象のもう一方の時間。null以外NullPointerException
- other
がnullである場合public boolean isAfter(OffsetTime other)
OffsetTime
のインスタントが指定された時間のそれより後にあるかどうかを確認します。
このメソッドは、時間のインスタントのみを比較するという点で、compareTo(java.time.OffsetTime)
での比較とは異なります。これは、同じ日付を使用して両方の時間をインスタントに変換し、それらのインスタントを比較することと同等です。
other
- 比較対象のもう一方の時間。null以外public boolean isBefore(OffsetTime other)
OffsetTime
のインスタントが指定された時間のそれより前にあるかどうかを確認します。
このメソッドは、時間のインスタントのみを比較するという点で、compareTo(java.time.OffsetTime)
での比較とは異なります。これは、同じ日付を使用して両方の時間をインスタントに変換し、それらのインスタントを比較することと同等です。
other
- 比較対象のもう一方の時間。null以外public boolean isEqual(OffsetTime other)
OffsetTime
のインスタントが指定された時間のそれと等しいかどうかを確認します。
このメソッドは、時間のインスタントのみを比較するという点で、compareTo(java.time.OffsetTime)
およびequals(java.lang.Object)
での比較とは異なります。これは、同じ日付を使用して両方の時間をインスタントに変換し、それらのインスタントを比較することと同等です。
other
- 比較対象のもう一方の時間。null以外public boolean equals(Object obj)
この比較は、ローカル時間およびオフセットに基づいて行われます。時系列上の同じインスタントに対して比較を行うには、isEqual(OffsetTime)
を使用します。
OffsetTime
型のオブジェクトのみが比較され、それ以外の型はfalseを返します。2つのTemporalAccessor
インスタンスのベースとなるローカル時間を比較するには、ChronoField.NANO_OF_DAY
をコンパレータとして使用します。
equals
、クラス: Object
obj
- チェックするオブジェクト、nullはfalseを返すObject.hashCode()
、HashMap
public int hashCode()
hashCode
、クラス: Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.