nablarch.core.util

Class DateUtil

java.lang.Object

nablarch.core.util.DateUtil

public final class DateUtil
extends java.lang.Object

日付ユーティリティ。

Author:

Miki Habu

Method Summary

Modifier and Type	Method and Description
static java.lang.String	addDay(java.lang.String date, int days) 指定された日付(yyyyMMdd形式)を指定された日数分加減算する。 負の値が指定された場合は、減算を行う。 例）addDay("19991231", 1) //--> "20000101"
static java.lang.String	addMonth(java.lang.String date, int month) 指定された日付(yyyyMMdd or yyyyMM形式)を指定された月数分加減算する。 負の値が指定された場合は、減算を行う。 例）addMonth("19991231", 1) //--> "20000131"
static java.lang.String	formatDate(java.lang.String date, java.lang.String pattern) 日付文字列(yyyyMMdd形式)を指定された形式でフォーマットする。
static java.util.Date	getDate(java.lang.String date) 日付文字列(yyyyMMdd形式)からDateクラスのインスタンスを取得する。
static long	getDays(java.lang.String dateFrom, java.lang.String dateTo) 指定された日付間の日数を取得する。 例）getDays("19991231", "20000101") //--> 1
static java.lang.String	getMonthEndDate(java.lang.String date) 指定された日付(yyyyMMdd or yyyyMM形式)の月末日を取得する。
static int	getMonths(java.lang.String monthFrom, java.lang.String monthTo) 指定された日付(yyyyMMdd or yyyyMM形式)間の月数を取得する。 例) DateUtil.getMonths("201102", "201103"); //--> 1
static boolean	isValid(java.lang.String date, java.lang.String format) このメソッドはロケールにLocale.getDefault()を使用して、DateUtil.isValid(String, String, Locale)を呼び出す。
static boolean	isValid(java.lang.String date, java.lang.String format, java.util.Locale locale) 指定された日付文字列がフォーマットどおりであり、実在する日であることをバリデーションする。 フォーマットにはSimpleDateFormatにて定められたフォーマットを指定する。 例)

Method Detail

getDate

@Published
public static java.util.Date getDate(java.lang.String date)

日付文字列(yyyyMMdd形式)からDateクラスのインスタンスを取得する。

Parameters:

date - 日付文字列(yyyyMMdd形式)

Returns:

日付文字列の日付が設定された、Dateクラスのインスタンス

Throws:

java.lang.IllegalArgumentException - 日付文字列のフォーマットが yyyyMMdd形式ではなかった場合

formatDate

@Published
public static java.lang.String formatDate(java.lang.String date,
                                                     java.lang.String pattern)

日付文字列(yyyyMMdd形式)を指定された形式でフォーマットする。

Parameters:

date - フォーマット対象の日付文字列(yyyyMMdd形式)

pattern - 日付のフォーマットを記述するパターン(yyyy/MM/ddなど。SimpleDateFormat参照)

Returns:

フォーマットされた日付文字列

Throws:

java.lang.IllegalArgumentException - 日付文字列のフォーマットが yyyyMMdd形式ではなかった場合

addDay

@Published
public static java.lang.String addDay(java.lang.String date,
                                                 int days)

指定された日付(yyyyMMdd形式)を指定された日数分加減算する。

負の値が指定された場合は、減算を行う。

例）addDay("19991231", 1) //--> "20000101"

Parameters:

date - 日付文字列（yyyyMMdd形式）

days - 加減算する日数（負の値の場合は、減算を行う。)

Returns:

計算後の日付文字列（yyyyMMdd形式）

addMonth

@Published
public static java.lang.String addMonth(java.lang.String date,
                                                   int month)

指定された日付(yyyyMMdd or yyyyMM形式)を指定された月数分加減算する。

負の値が指定された場合は、減算を行う。

例）addMonth("19991231", 1) //--> "20000131"

Parameters:

date - 日付文字列(yyyyMMdd or yyyyMM形式)

month - 加減算する月数(負の値の場合は、減算を行う。)

Returns:

計算後の日付文字列

getDays

@Published
public static long getDays(java.lang.String dateFrom,
                                      java.lang.String dateTo)

指定された日付間の日数を取得する。

例）getDays("19991231", "20000101") //--> 1

Parameters:

dateFrom - 開始日付文字列（yyyyMMdd形式）

dateTo - 終了日付文字列（yyyyMMdd形式）

Returns:

日数（同一日であれば0、 開始日付文字列 ＞ 終了日付文字列であればマイナス値）

getMonths

@Published
public static int getMonths(java.lang.String monthFrom,
                                       java.lang.String monthTo)

指定された日付(yyyyMMdd or yyyyMM形式)間の月数を取得する。

例)
DateUtil.getMonths("201102", "201103"); //--> 1

Parameters:

monthFrom - 開始日付文字列(yyyyMMdd or yyyyMM形式)

monthTo - 終了日付文字列(yyyyMMdd or yyyyMM形式)

Returns:

月数（同一日であれば0、 開始日付文字列 ＞ 終了日付文字列であればマイナス値）

getMonthEndDate

@Published
public static java.lang.String getMonthEndDate(java.lang.String date)

指定された日付(yyyyMMdd or yyyyMM形式)の月末日を取得する。

Parameters:

date - 日付(yyyyMMdd or yyyyMM形式)

Returns:

指定された日付の月末日

isValid

@Published
public static boolean isValid(java.lang.String date,
                                         java.lang.String format)

このメソッドはロケールにLocale.getDefault()を使用して、DateUtil.isValid(String, String, Locale)を呼び出す。

Parameters:

date - バリデーション対象日付文字列

format - フォーマット

Returns:

dateがformat形式で、実在する日であればtrue

Throws:

java.lang.IllegalArgumentException - dateがnullか、formatがnullまたは空文字の場合

isValid

@Published
public static boolean isValid(java.lang.String date,
                                         java.lang.String format,
                                         java.util.Locale locale)

指定された日付文字列がフォーマットどおりであり、実在する日であることをバリデーションする。
フォーマットにはSimpleDateFormatにて定められたフォーマットを指定する。
例)

 //2016年3月31日は存在するため、true。
 DateUtil.isValid("20160331", "yyyyMMdd"); //--> true

 //2016年3月32日は存在しないため、false。
 DateUtil.isValid("20160332", "yyyyMMdd"); //--> false
 

Parameters:

date - バリデーション対象日付文字列

format - フォーマット

locale - フォーマットに使用するロケール

Returns:

dateがformat形式で、実在する日であればtrue

Throws:

java.lang.IllegalArgumentException - dateがnullか、formatがnullまたは空文字の場合