Apache Commons Lang – DateUtils(AddYears / AddMonths / AddWeeks / AddDays / AddHours / AddMinutes / AddSeconds / AddMilliseconds)


引き続き、DateUtilsクラスの説明です。

今回は、日付の加算・減算についてです。


addYears

public static java.util.Date addYears(java.util.Date date, int amount)

指定された年を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
年にマイナス値を指定した場合は減算となります。

DateUtils.addYears("28 Mar 2002 13:45:00.000", 1)  =
                   "28 Mar 2003 13:45:00.000"
DateUtils.addYears("28 Mar 2002 13:45:00.000", -1) =
                   "28 Mar 2001 13:45:00.000"

DateUtils.addYears(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算する年
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


addMonths

public static java.util.Date addMonths(java.util.Date date, int amount)

指定された月を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
月にマイナス値を指定した場合は減算となります。

DateUtils.addMonths("28 Mar 2002 13:45:00.000", 1)  =
                    "28 Apr 2002 13:45:00.000"
DateUtils.addMonths("28 Mar 2002 13:45:00.000", -1) =
                    "28 Feb 2002 13:45:00.000"

DateUtils.addMonths(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算する月
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


addWeeks

public static java.util.Date addWeeks(java.util.Date date, int amount)

指定された週を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
週にマイナス値を指定した場合は減算となります。

DateUtils.addWeeks("28 Mar 2002 13:45:00.000", 1)  =
                   "04 Apr 2002 13:45:00.000"
DateUtils.addWeeks("28 Mar 2002 13:45:00.000", -1) =
                   "21 Mar 2002 13:45:00.000"

DateUtils.addWeeks(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算する週
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


addDays

public static java.util.Date addDays(java.util.Date date, int amount)

指定された日を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
日にマイナス値を指定した場合は減算となります。

DateUtils.addDays("28 Mar 2002 13:45:00.000", 1)  =
                  "29 Mar 2002 13:45:00.000"
DateUtils.addDays("28 Mar 2002 13:45:00.000", -1) =
                  "27 Mar 2002 13:45:00.000"

DateUtils.addDays(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算する日
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


addHours

public static java.util.Date addHours(java.util.Date date, int amount)

指定された時間を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
時間にマイナス値を指定した場合は減算となります。

DateUtils.addHours("28 Mar 2002 13:45:00.000", 1)  =
                   "28 Mar 2002 14:45:00.000"
DateUtils.addHours("28 Mar 2002 13:45:00.000", -1) =
                   "28 Mar 2002 12:45:00.000"

DateUtils.addHours(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算する時間
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


addMinutes

public static java.util.Date addMinutes(java.util.Date date, int amount)

指定された分を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
分にマイナス値を指定した場合は減算となります。

DateUtils.addMinutes("28 Mar 2002 13:45:00.000", 1)  =
                     "28 Mar 2002 13:46:00.000"
DateUtils.addMinutes("28 Mar 2002 13:45:00.000", -1) =
                     "28 Mar 2002 13:44:00.000"

DateUtils.addMinutes(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算する分
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


addSeconds

public static java.util.Date addSeconds(java.util.Date date, int amount)

指定された秒を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
秒にマイナス値を指定した場合は減算となります。

DateUtils.addSeconds("28 Mar 2002 13:45:00.000", 1)  =
                     "28 Mar 2002 13:45:01.000"
DateUtils.addSeconds("28 Mar 2002 13:45:00.000", -1) =
                     "28 Mar 2002 13:44:59.000"

DateUtils.addSeconds(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算する秒
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


addMilliseconds

public static java.util.Date addMilliseconds(java.util.Date date, int amount)

指定されたミリ秒を加算したDateオブジェクトを生成します。
元のDateオブジェクトに変更はありません。
ミリ秒にマイナス値を指定した場合は減算となります。

DateUtils.addMilliseconds("28 Mar 2002 13:45:00.000", 1)  =
                          "28 Mar 2002 13:45:00.001"
DateUtils.addMilliseconds("28 Mar 2002 13:45:00.000", -1) =
                          "28 Mar 2002 13:44:59.999"

DateUtils.addMilliseconds(null, 1) = IllegalArgumentException


パラメータ:
date – 元となるDate型の日付
amount – 加算するミリ秒
戻り値:
Date型の日付
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合

関連記事

  1. コメント 0

  1. トラックバック 0

return top