nablarch.core.util

Class DateUtil

java.lang.Object

nablarch.core.util.DateUtil

public final class DateUtil
extends java.lang.Object

日付ユーティリティ。

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.util.Date date, java.lang.String format) このメソッドはThreadContextから取得したロケールを指定して formatDate(Date, String, Locale)を呼び出す。
static java.lang.String	formatDate(java.util.Date date, java.lang.String format, java.util.Locale locale) 指定されたフォーマットとロケールを使用して日付を変換する。 指定するフォーマットはSimpleDateFormatの仕様に準拠すること。 例:
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 java.lang.String	getNumbersOnlyFormat(java.lang.String yyyyMMddFormat) フォーマット文字列から年月日の区切り文字を取り除いた値を返す。
static java.util.Date	getParsedDate(java.lang.String date, java.lang.String format) このメソッドはロケールにLocale.getDefault()を使用して getParsedDate(String, String, Locale)を呼び出す。
static java.util.Date	getParsedDate(java.lang.String date, java.lang.String format, java.util.Locale locale) dateをformat形式でパースした結果のDateインスタンスを返却する。 dateがformat形式ではない場合、または実在しない日付である場合、nullを返却する。 例)
static boolean	isValid(java.lang.String date, java.lang.String format) このメソッドはロケールにLocale.getDefault()を使用して、isValid(String, String, Locale)を呼び出す。
static boolean	isValid(java.lang.String date, java.lang.String format, java.util.Locale locale) 指定された日付文字列がフォーマットどおりであり、実在する日であることをバリデーションする。 フォーマットにはSimpleDateFormatにて定められたフォーマットを指定する。 例)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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()を使用して、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または空文字の場合

getParsedDate

@Published(tag="architect")
public static java.util.Date getParsedDate(java.lang.String date,
                                                                       java.lang.String format)

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

Parameters:

date - パース対象日付文字列

format - 日付文字列フォーマット

Returns:

dateをformat形式でパースした結果のDateインスタンス

Throws:

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

getParsedDate

@Published(tag="architect")
public static java.util.Date getParsedDate(java.lang.String date,
                                                                       java.lang.String format,
                                                                       java.util.Locale locale)

dateをformat形式でパースした結果のDateインスタンスを返却する。
dateがformat形式ではない場合、または実在しない日付である場合、nullを返却する。
例)

 //正常処理
 DateUtil.getParsedDate("20160307160112", "yyyyMMddHHmmss", Locale.JAPANESE); // Mon Mar 07 12:12:12 JST 2016

 //20160304(date)の形式が、yyyymm形式でないため、null。
 DateUtil.getParsedDate("20160304", "yyyyMM", Locale.JAPANESE); //--> null

 //2016年3月32日が存在しない日付のため、null。
 DateUtil.getParsedDate("20160332", "yyyyMMdd", Locale.JAPANESE); //--> null
 

Parameters:

date - パース対象日付文字列

format - 日付文字列フォーマット

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

Returns:

dateをformat形式でパースした結果のDateインスタンス

Throws:

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

getNumbersOnlyFormat

@Published(tag="architect")
public static java.lang.String getNumbersOnlyFormat(java.lang.String yyyyMMddFormat)

フォーマット文字列から年月日の区切り文字を取り除いた値を返す。

 フォーマットのパターン文字は、y(年)、M(月)、d(月における日)のみ指定可能。
 
 フォーマット文字列に年月日の区切り文字が含まれない場合は nullを返す。
 下記に「フォーマット文字列 //--> 戻り値」形式で例を示す。
 
 "yyyy/MM/dd" //--> "yyyyMMdd"
 "yyyy-MM-dd" //--> "yyyyMMdd"
 "MM/dd/yyyy" //--> "MMddyyyy"
 "yyyyMMdd"   //-->  null
 
 

Parameters:

yyyyMMddFormat - フォーマット文字列

Returns:

フォーマット文字列から年月日の区切り文字を取り除いた値

formatDate

@Published(tag="architect")
public static java.lang.String formatDate(java.util.Date date,
                                                                      java.lang.String format)

このメソッドはThreadContextから取得したロケールを指定して formatDate(Date, String, Locale)を呼び出す。

Parameters:

date - 日付(null不可)

format - フォーマット(null不可)

Returns:

変換した値

formatDate

@Published(tag="architect")
public static java.lang.String formatDate(java.util.Date date,
                                                                      java.lang.String format,
                                                                      java.util.Locale locale)

指定されたフォーマットとロケールを使用して日付を変換する。

指定するフォーマットはSimpleDateFormatの仕様に準拠すること。

例:

 Date date = Calendar.getInstance().getTime();              //--> 2012/11/13
 
 I18NUtil.formatDate(date, "yyyy/MMM/dd", Locale.JAPANESE); //--> 2012/11/13
 I18NUtil.formatDate(date, "dd MMM yyyy", Locale.ENGLISH);  //--> 13 Nov 2012
 

Parameters:

date - 日付

format - フォーマット

locale - ロケール

Returns:

変換した値

Throws:

java.lang.IllegalArgumentException - 日付、フォーマット、ロケールがnullの場合、または日付の変換に失敗した場合