DateUtil (NablarchApi)

java.lang.Object
- nablarch.core.util.DateUtil

public final class DateUtil
extends java.lang.Object

日付ユーティリティ。

Author:: Miki Habu

Method Summary

All Methods Static Methods Concrete Methods
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`から取得したロケールを指定して `DateUtil.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()`を使用して `DateUtil.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()`を使用して、`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または空文字の場合
  - getParsedDate
```
@Published(tag="architect")
public static java.util.Date getParsedDate(java.lang.String date,
                                                                       java.lang.String format)
```
    このメソッドはロケールにLocale.getDefault()を使用して DateUtil.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から取得したロケールを指定して DateUtil.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の場合、または日付の変換に失敗した場合

Class DateUtil

Method Summary

Method Detail

getDate

formatDate

addDay

addMonth

getDays

getMonths

getMonthEndDate

isValid

isValid

getParsedDate

getParsedDate

getNumbersOnlyFormat

formatDate

formatDate