Apache Commons Lang – DateUtils(IsSameDay / IsSameInstant / IsSameLocalTime)


DateUtilsクラスでは、日付の比較や変更を簡単にするための機能が提供されています。

まずは、日付の比較についてです。


isSameDay

public static boolean isSameDay(java.util.Date date1, java.util.Date date2)

同じ日付かどうかチェックします。
時刻は関係ありません。

DateUtils.isSameDay("28 Mar 2002 13:45",
                    "28 Mar 2002 06:01") = true
DateUtils.isSameDay("28 Mar 2002 13:45",
                    "12 Mar 2002 13:45") = false

DateUtils.isSameDay("28 Mar 2002 13:45", null) = IllegalArgumentException
DateUtils.isSameDay(null, "28 Mar 2002 06:01") = IllegalArgumentException
DateUtils.isSameDay(null, null)                = IllegalArgumentException


パラメータ:
date1 – Date型の日付
date2 – Date型の日付
戻り値:
同じ日付の場合はtrue、そうでない場合はfalse
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


isSameDay

public static boolean isSameDay(java.util.Calendar cal1, java.util.Calendar cal2)

同じ日付かどうかチェックします。
時刻は関係ありません。

DateUtils.isSameDay("28 Mar 2002 13:45",
                    "28 Mar 2002 06:01") = true
DateUtils.isSameDay("28 Mar 2002 13:45",
                    "12 Mar 2002 13:45") = false

DateUtils.isSameDay("28 Mar 2002 13:45", null) = IllegalArgumentException
DateUtils.isSameDay(null, "28 Mar 2002 06:01") = IllegalArgumentException
DateUtils.isSameDay(null, null)                = IllegalArgumentException


パラメータ:
cal1 – Calendar
cal2 – Calendar
戻り値:
同じ日付の場合はtrue、そうでない場合はfalse
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


isSameInstant

public static boolean isSameInstant(java.util.Date date1, java.util.Date date2)

同じ日付かどうかチェックします。
ミリ秒の単位まで比較対象となります。

DateUtils.isSameInstant("28 Mar 2002 13:45:00.000",
                        "28 Mar 2002 13:45:00.000") = true
DateUtils.isSameInstant("28 Mar 2002 13:45:00.001",
                        "28 Mar 2002 13:45:00.002") = false

DateUtils.isSameInstant("28 Mar 2002 13:45:00.000", null) = IllegalArgumentException
DateUtils.isSameInstant(null, "28 Mar 2002 13:45:00.000") = IllegalArgumentException
DateUtils.isSameInstant(null, null)                       = IllegalArgumentException


パラメータ:
date1 – Date型の日付
date2 – Date型の日付
戻り値:
同じ日付の場合はtrue、そうでない場合はfalse
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


isSameInstant

public static boolean isSameInstant(java.util.Calendar cal1, java.util.Calendar cal2)

同じ日付かどうかチェックします。
ミリ秒の単位まで比較対象となります。

DateUtils.isSameInstant("28 Mar 2002 13:45:00.000",
                        "28 Mar 2002 13:45:00.000") = true
DateUtils.isSameInstant("28 Mar 2002 13:45:00.001",
                        "28 Mar 2002 13:45:00.002") = false

DateUtils.isSameInstant("28 Mar 2002 13:45:00.000", null) = IllegalArgumentException
DateUtils.isSameInstant(null, "28 Mar 2002 13:45:00.000") = IllegalArgumentException
DateUtils.isSameInstant(null, null)                       = IllegalArgumentException


パラメータ:
cal1 – Calendar型の日付
cal2 – Calendar型の日付
戻り値:
同じ日付の場合はtrue、そうでない場合はfalse
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合


isSameLocalTime

public static boolean isSameLocalTime(java.util.Calendar cal1, java.util.Calendar cal2)

ローカル時刻で、同じ日付かどうかチェックします。
ミリ秒の単位まで比較対象となります。

//US時刻とUS時刻の比較
DateUtils.isSameLocalTime("28 Mar 2002 13:45:00.000",
                          "28 Mar 2002 13:45:00.000") = true

//US時刻と日本時刻の比較
DateUtils.isSameLocalTime("28 Mar 2002 13:45:00.000",
                          "2002/03/28 13:45:00.000")  = false

DateUtils.isSameLocalTime("28 Mar 2002 13:45:00.000", null) = IllegalArgumentException
DateUtils.isSameLocalTime(null, "28 Mar 2002 13:45:00.000") = IllegalArgumentException
DateUtils.isSameLocalTime(null, null)                       = IllegalArgumentException


パラメータ:
cal1 – Calendar型の日付
cal2 – Calendar型の日付
戻り値:
同じ日付の場合はtrue、そうでない場合はfalse
例外:
java.lang.IllegalArgumentException – 引数にNULLが指定されている場合

関連記事

  1. コメント 0

  1. トラックバック 0

return top