Apache Commons Lang – DateUtils(GetFragmentInDays / GetFragmentInHours / GetFragmentInMinutes / GetFragmentInSeconds / GetFragmentInMilliseconds)


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

今回は、範囲内の日数や時間の取得についてです。


getFragmentInDays

public static long getFragmentInDays(java.util.Date date, int fragment)

指定されたフラグメントの範囲内の日数を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInDays("28 Jan 2008", Calendar.MONTH)       = 28
DateUtils.getFragmentInDays("28 Feb 2008", Calendar.MONTH)       = 28
DateUtils.getFragmentInDays("28 Jan 2008", Calendar.YEAR)        = 28
DateUtils.getFragmentInDays("28 Feb 2008", Calendar.YEAR)        = 59
    (January:31[Days] + February:28[Days])
DateUtils.getFragmentInDays("28 Jan 2008", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInDays(null", Calendar.MONTH) = IllegalArgumentException
DateUtils.getFragmentInDays("28 Jan 2008", -1)     = IllegalArgumentException


パラメータ:
date – Date型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:
日数
例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInDays

public static long getFragmentInDays(java.util.Calendar calendar, int fragment)

指定されたフラグメントの範囲内の日数を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInDays("28 Jan 2008", Calendar.MONTH)       = 28
DateUtils.getFragmentInDays("28 Feb 2008", Calendar.MONTH)       = 28
DateUtils.getFragmentInDays("28 Jan 2008", Calendar.YEAR)        = 28
DateUtils.getFragmentInDays("28 Feb 2008", Calendar.YEAR)        = 59
    (January:31[Days] + February:28[Days])
DateUtils.getFragmentInDays("28 Jan 2008", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInDays(null", Calendar.MONTH) = IllegalArgumentException
DateUtils.getFragmentInDays("28 Jan 2008", -1)     = IllegalArgumentException


パラメータ:
calendar – Calendar型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:
日数
例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInHours

public static long getFragmentInHours(java.util.Date date, int fragment)

指定されたフラグメントの範囲内の時間を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInHours("1 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 7
DateUtils.getFragmentInHours("6 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 7
DateUtils.getFragmentInHours("1 Jan 2008 07:15:10.538", Calendar.MONTH)        = 7
    (7[Hours])
DateUtils.getFragmentInHours("6 Jan 2008 07:15:10.538", Calendar.MONTH)        = 127
    (5[Days] * 24 + 7[Hours])
DateUtils.getFragmentInHours("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInHours(null", Calendar.DAY_OF_YEAR)   = IllegalArgumentException
DateUtils.getFragmentInHours("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
date – Date型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:
時間
例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInHours

public static long getFragmentInHours(java.util.Calendar calendar, int fragment)

指定されたフラグメントの範囲内の時間を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInHours("1 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 7
DateUtils.getFragmentInHours("6 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 7
DateUtils.getFragmentInHours("1 Jan 2008 07:15:10.538", Calendar.MONTH)        = 7
    (7[Hours])
DateUtils.getFragmentInHours("6 Jan 2008 07:15:10.538", Calendar.MONTH)        = 127
    (5[Days] * 24 + 7[Hours])
DateUtils.getFragmentInHours("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInHours(null", Calendar.DAY_OF_YEAR)   = IllegalArgumentException
DateUtils.getFragmentInHours("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
calendar – Calendar型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:
時間
例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInMinutes

public static long getFragmentInMinutes(java.util.Date date, int fragment)

指定されたフラグメントの範囲内の分を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInMinutes("1 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 15
DateUtils.getFragmentInMinutes("6 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 15
DateUtils.getFragmentInMinutes("1 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 435
    (7[Hours] * 60 + 15[Minutes])
DateUtils.getFragmentInMinutes("6 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 435
    (7[Hours] * 60 + 15[Minutes])
DateUtils.getFragmentInMinutes("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInMinutes(null", Calendar.HOUR_OF_DAY)   = IllegalArgumentException
DateUtils.getFragmentInMinutes("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
date – Date型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:

例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInMinutes

public static long getFragmentInMinutes(java.util.Calendar calendar, int fragment)

指定されたフラグメントの範囲内の分を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInMinutes("1 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 15
DateUtils.getFragmentInMinutes("6 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 15
DateUtils.getFragmentInMinutes("1 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 435
    (7[Hours] * 60 + 15[Minutes])
DateUtils.getFragmentInMinutes("6 Jan 2008 07:15:10.538", Calendar.DAY_OF_YEAR)  = 435
    (7[Hours] * 60 + 15[Minutes])
DateUtils.getFragmentInMinutes("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInMinutes(null", Calendar.HOUR_OF_DAY)   = IllegalArgumentException
DateUtils.getFragmentInMinutes("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
calendar – Calendar型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:

例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInSeconds

public static long getFragmentInSeconds(java.util.Date date, int fragment)

指定されたフラグメントの範囲内の秒を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInSeconds("1 Jan 2008 07:15:10.538", Calendar.MINUTE)       = 10
DateUtils.getFragmentInSeconds("6 Jan 2008 07:15:10.538", Calendar.MINUTE)       = 10
DateUtils.getFragmentInSeconds("1 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 910
    (15[Minutes] * 60 + 10[Seconds])
DateUtils.getFragmentInSeconds("6 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 910
    (15[Minutes] * 60 + 10[Seconds])
DateUtils.getFragmentInSeconds("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInSeconds(null", Calendar.MINUTE)        = IllegalArgumentException
DateUtils.getFragmentInSeconds("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
date – Date型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:

例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInSeconds

public static long getFragmentInSeconds(java.util.Calendar calendar, int fragment)

指定されたフラグメントの範囲内の秒を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInSeconds("1 Jan 2008 07:15:10.538", Calendar.MINUTE)       = 10
DateUtils.getFragmentInSeconds("6 Jan 2008 07:15:10.538", Calendar.MINUTE)       = 10
DateUtils.getFragmentInSeconds("1 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 910
    (15[Minutes] * 60 + 10[Seconds])
DateUtils.getFragmentInSeconds("6 Jan 2008 07:15:10.538", Calendar.HOUR_OF_DAY)  = 910
    (15[Minutes] * 60 + 10[Seconds])
DateUtils.getFragmentInSeconds("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInSeconds(null", Calendar.MINUTE)        = IllegalArgumentException
DateUtils.getFragmentInSeconds("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
calendar – Calendar型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:

例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInMilliseconds

public static long getFragmentInMilliseconds(java.util.Date date, int fragment)

指定されたフラグメントの範囲内のミリ秒を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInMilliseconds("1 Jan 2008 07:15:10.538", Calendar.SECOND) = 538
DateUtils.getFragmentInMilliseconds("6 Jan 2008 07:15:10.538", Calendar.SECOND) = 538
DateUtils.getFragmentInMilliseconds("1 Jan 2008 07:15:10.538", Calendar.MINUTE) = 10538
    (10[Seconds] * 1000 + 538[Milliseconds])
DateUtils.getFragmentInMilliseconds("6 Jan 2008 07:15:10.538", Calendar.MINUTE) = 10538
    (10[Seconds] * 1000 + 538[Milliseconds])
DateUtils.getFragmentInMilliseconds("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInMilliseconds(null", Calendar.MINUTE)        = IllegalArgumentException
DateUtils.getFragmentInMilliseconds("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
date – Date型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:
ミリ秒
例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合


getFragmentInMilliseconds

public static long getFragmentInMilliseconds(java.util.Calendar calendar, int fragment)

指定されたフラグメントの範囲内のミリ秒を取得します。
指定されたフラグメントより大きなすべての日付フィールドは無視されます。

DateUtils.getFragmentInMilliseconds("1 Jan 2008 07:15:10.538", Calendar.SECOND) = 538
DateUtils.getFragmentInMilliseconds("6 Jan 2008 07:15:10.538", Calendar.SECOND) = 538
DateUtils.getFragmentInMilliseconds("1 Jan 2008 07:15:10.538", Calendar.MINUTE) = 10538
    (10[Seconds] * 1000 + 538[Milliseconds])
DateUtils.getFragmentInMilliseconds("6 Jan 2008 07:15:10.538", Calendar.MINUTE) = 10538
    (10[Seconds] * 1000 + 538[Milliseconds])
DateUtils.getFragmentInMilliseconds("16 Jan 2008 07:15:10.538", Calendar.MILLISECOND) = 0

DateUtils.getFragmentInMilliseconds(null", Calendar.MINUTE)        = IllegalArgumentException
DateUtils.getFragmentInMilliseconds("1 Jan 2008 07:15:10.538", -1) = IllegalArgumentException


パラメータ:
calendar – Calendar型の日付
fragment – フラグメント
以下の定数から選択します。
Calendar.YEAR, Calendar.MONTH, Calendar.DAY_OF_YEAR, Calendar.DATE,
Calendar.HOUR_OF_DAY, Calendar.MINUTE, Calendar.SECOND Calendar.MILLISECOND
戻り値:
ミリ秒
例外:
java.lang.IllegalArgumentException – 日付にNULLが指定されている場合
java.lang.IllegalArgumentException – 不正なフラグメントが指定されている場合

関連記事

  1. コメント 0

  1. トラックバック 0

return top