指定した日時に、このオブジェクトが表現する長さの時間を加えた、未来の日時を取得する。
指定した日時に、このオブジェクトが表現する長さの時間を加えた、未来の日時を取得する。
元となる日時
このオブジェクトが表現する長さの時間が経過した未来の日時
addAmountToTimePoint(long, TimePoint)
指定した日付に、このオブジェクトが表現する長さの時間を加えた、未来の日付を取得する。
指定した日付に、このオブジェクトが表現する長さの時間を加えた、未来の日付を取得する。
このオブジェクトが表現する時間の長さの単位が 日 未満である場合は、元の日付をそのまま返す。
元となる日付
このオブジェクトが表現する長さの時間が経過した未来の日付
このオブジェクトのquantity
フィールド(量)を返す。
このオブジェクトのquantity
フィールド(量)を返す。
CAUTION: このメソッドは、このオブジェクトがカプセル化する要素を外部に暴露する。取り扱いには充分注意のこと。
量
このオブジェクトのunit
フィールド(単位)を返す。
このオブジェクトのunit
フィールド(単位)を返す。
CAUTION: このメソッドは、このオブジェクトがカプセル化する要素を外部に暴露する。取り扱いには充分注意のこと。
単位
時間量同士の比較を行う。
時間量同士の比較を行う。
基本単位(baseUnit)換算で比較し、時間量の少ない方を「小さい」と判断する。 同じ基本単位に変換できない場合はjava.lang.ClassCastExceptionをスローする。
例えば「1ヶ月間」と「30日間」は、同じ基本単位に変換できないため、比較不能である。
比較対照
java.util.Comparable
compareTo(Object)に準じる
ClassCastException
引数other
の単位を、このオブジェクトの単位に変換できない場合
この時間量を、指定した時間量 other
で割った商(割合)を取得する。
この時間量を、指定した時間量 other
で割った商(割合)を取得する。
割る数
割合
ArithmeticException
引数divisor
が0だった場合
IllegalArgumentException
引数divisorの単位を、このオブジェクトの単位に変換できない場合
このオブジェクトが表現する時間量と、引数 other
に与えた時間量の差を返す。
このオブジェクトが表現する時間量と、引数 other
に与えた時間量の差を返す。
期間
時間量の差
IllegalArgumentException
引数otherの単位を、このオブジェクトの単位に変換できず、かつ、
どちらのquantityも0ではない場合もしくは、引数otherの長さが、このオブジェクトよりも長い場合
この期間を1単位で表せる最大の時間単位を求める。
この期間を1単位で表せる最大の時間単位を求める。
例えば、1〜23時間, 25〜47時間は hours だが、24時間, 48時間は days である。
時間単位
このオブジェクトが表現する時間量と、引数 other
に与えた時間量の和を返す。
このオブジェクトが表現する時間量と、引数 other
に与えた時間量の和を返す。
期間
時間量の和
IllegalArgumentException
引数otherの単位を、このオブジェクトの単位に変換できず、かつ、どちらのquantityも0ではない場合
終了日時とこのオブジェクトが表現する時間量より、期間を生成する。
終了日時とこのオブジェクトが表現する時間量より、期間を生成する。
終了日時(上側限界値)
期間
指定した日付を開始日とする、このオブジェクトが表現する長さを持つ期間を生成する。
指定した日付を開始日とする、このオブジェクトが表現する長さを持つ期間を生成する。
生成する期間の開始日と終了日は期間に含む(閉じている)開区間を生成する。
この時間量の単位が "日" 未満である場合は、開始日と終了日は同日となる。
開始日時(下側限界値). Limitless[CalendarDate]
の場合は、限界がないことを表す
期間
指定した日時を開始日時とする、このオブジェクトが表現する長さを持つ期間を生成する。
指定した日時を開始日時とする、このオブジェクトが表現する長さを持つ期間を生成する。
生成する期間の開始日時は区間に含み(閉じている)、終了日時は区間に含まない(開いている)半開期間を生成する。
開始日時(下側限界値). Limitless[CalendarDate]
の場合は、限界がないことを表す
期間
指定した日時に、このオブジェクトが表現する長さの時間を引いた、過去の日時を取得する。
指定した日時に、このオブジェクトが表現する長さの時間を引いた、過去の日時を取得する。
元となる日時
このオブジェクトが表現する長さのを引いた、過去の日時
#addAmountToTimePoint(long, TimePoint)
この時間量の文字列表現を返す。
この時間量の文字列表現を返す。
時間量の文字列表現
この時間量の文字列表現を返す。
この時間量の文字列表現を返す。
時間量の文字列表現
#toNormalizedString()
指定した年月に、このオブジェクトが表現する長さの時間を加えた、未来の年月を取得する。
指定した年月に、このオブジェクトが表現する長さの時間を加えた、未来の年月を取得する。
このオブジェクトが表現する時間の長さの単位が 月 未満である場合は、元の年月をそのまま返す。
元となる年月
このオブジェクトが表現する長さの時間が経過した未来の年月
(Since version 0.1.18) Use addedTo(month: CalendarYearMonth, zoneId: ZoneId) method instead
指定した日付に、このオブジェクトが表現する長さの時間を加えた、未来の日付を取得する。
指定した日付に、このオブジェクトが表現する長さの時間を加えた、未来の日付を取得する。
このオブジェクトが表現する時間の長さの単位が 日 未満である場合は、元の日付をそのまま返す。
元となる日付
タイムゾーン
このオブジェクトが表現する長さの時間が経過した未来の日付
(Since version 0.1.18) Use addedTo(day: CalendarDate, zoneId: ZoneId) method instead
指定した日付に、このオブジェクトが表現する長さの時間を引いた、過去の日付を取得する。
指定した日付に、このオブジェクトが表現する長さの時間を引いた、過去の日付を取得する。
このオブジェクトが表現する時間の長さの単位が 日 未満である場合は、元の日付をそのまま返す。
元となる日付
このオブジェクトが表現する長さのを引いた、過去の日付
(Since version 0.1.18) Use subtractedFrom(day: CalendarDate, zoneId: ZoneId) method instead
時間量(時間の長さ・期間の長さなど)を表すクラス。
負の時間量は表現しない。