DateUtil (NablarchApi)

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

```
public final class DateUtil
extends Object
```
日付ユーティリティ。

作成者:

Miki Habu

メソッドのサマリー

すべてのメソッド staticメソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`static String`	`addDay(String date, int days)` 指定された日付(yyyyMMdd形式)を指定された日数分加減算する。
`static String`	`addMonth(String date, int month)` 指定された日付(yyyyMMdd or yyyyMM形式)を指定された月数分加減算する。
`static String`	`formatDate(String date, String pattern)` 日付文字列(yyyyMMdd形式)を指定された形式でフォーマットする。
`static Date`	`getDate(String date)` 日付文字列(yyyyMMdd形式)から`Date`クラスのインスタンスを取得する。
`static long`	`getDays(String dateFrom, String dateTo)` 指定された日付間の日数を取得する。
`static String`	`getMonthEndDate(String date)` 指定された日付(yyyyMMdd or yyyyMM形式)の月末日を取得する。
`static int`	`getMonths(String monthFrom, String monthTo)` 指定された日付(yyyyMMdd or yyyyMM形式)間の月数を取得する。
`static boolean`	`isValid(String date, String format)` このメソッドはロケールに`Locale.getDefault()`を使用して、`DateUtil.isValid(String, String, Locale)`を呼び出す。
`static boolean`	`isValid(String date, String format, Locale locale)` 指定された日付文字列がフォーマットどおりであり、実在する日であることをバリデーションする。

- メソッドの詳細
  - getDate
```
@Published
public static Date getDate(String date)
```
    日付文字列(yyyyMMdd形式)からDateクラスのインスタンスを取得する。
    
    パラメータ:
    
    date - 日付文字列(yyyyMMdd形式)
    
    戻り値:
    
    日付文字列の日付が設定された、Dateクラスのインスタンス
    
    例外:
    
    IllegalArgumentException - 日付文字列のフォーマットが yyyyMMdd形式ではなかった場合
  - formatDate
```
@Published
public static String formatDate(String date,
                                           String pattern)
```
    日付文字列(yyyyMMdd形式)を指定された形式でフォーマットする。
    
    パラメータ:
    
    date - フォーマット対象の日付文字列(yyyyMMdd形式)
    
    pattern - 日付のフォーマットを記述するパターン(yyyy/MM/ddなど。SimpleDateFormat参照)
    
    戻り値:
    
    フォーマットされた日付文字列
    
    例外:
    
    IllegalArgumentException - 日付文字列のフォーマットが yyyyMMdd形式ではなかった場合
  - addDay
```
@Published
public static String addDay(String date,
                                       int days)
```
    指定された日付(yyyyMMdd形式)を指定された日数分加減算する。
    
    負の値が指定された場合は、減算を行う。
    例）addDay("19991231", 1) //--> "20000101"
    
    パラメータ:
    
    date - 日付文字列（yyyyMMdd形式）
    
    days - 加減算する日数（負の値の場合は、減算を行う。)
    
    戻り値:
    
    計算後の日付文字列（yyyyMMdd形式）
  - addMonth
```
@Published
public static String addMonth(String date,
                                         int month)
```
    指定された日付(yyyyMMdd or yyyyMM形式)を指定された月数分加減算する。
    
    負の値が指定された場合は、減算を行う。
    例）addMonth("19991231", 1) //--> "20000131"
    
    パラメータ:
    
    date - 日付文字列(yyyyMMdd or yyyyMM形式)
    
    month - 加減算する月数(負の値の場合は、減算を行う。)
    
    戻り値:
    
    計算後の日付文字列
  - getDays
```
@Published
public static long getDays(String dateFrom,
                                      String dateTo)
```
    指定された日付間の日数を取得する。
    
    例）getDays("19991231", "20000101") //--> 1
    
    パラメータ:
    
    dateFrom - 開始日付文字列（yyyyMMdd形式）
    
    dateTo - 終了日付文字列（yyyyMMdd形式）
    
    戻り値:
    
    日数（同一日であれば0、開始日付文字列＞終了日付文字列であればマイナス値）
  - getMonths
```
@Published
public static int getMonths(String monthFrom,
                                       String monthTo)
```
    指定された日付(yyyyMMdd or yyyyMM形式)間の月数を取得する。
    例)
    DateUtil.getMonths("201102", "201103"); //--> 1
    
    パラメータ:
    
    monthFrom - 開始日付文字列(yyyyMMdd or yyyyMM形式)
    
    monthTo - 終了日付文字列(yyyyMMdd or yyyyMM形式)
    
    戻り値:
    
    月数（同一日であれば0、開始日付文字列＞終了日付文字列であればマイナス値）
  - getMonthEndDate
```
@Published
public static String getMonthEndDate(String date)
```
    指定された日付(yyyyMMdd or yyyyMM形式)の月末日を取得する。
    
    パラメータ:
    
    date - 日付(yyyyMMdd or yyyyMM形式)
    
    戻り値:
    
    指定された日付の月末日
  - isValid
```
@Published
public static boolean isValid(String date,
                                         String format)
```
    このメソッドはロケールにLocale.getDefault()を使用して、DateUtil.isValid(String, String, Locale)を呼び出す。
    
    パラメータ:
    
    date - バリデーション対象日付文字列
    
    format - フォーマット
    
    戻り値:
    
    dateがformat形式で、実在する日であればtrue
    
    例外:
    
    IllegalArgumentException - dateがnullか、formatがnullまたは空文字の場合
  - isValid
```
@Published
public static boolean isValid(String date,
                                         String format,
                                         Locale locale)
```
    指定された日付文字列がフォーマットどおりであり、実在する日であることをバリデーションする。
    フォーマットにはSimpleDateFormatにて定められたフォーマットを指定する。
    例)
    //2016年3月31日は存在するため、true。 DateUtil.isValid("20160331", "yyyyMMdd"); //--> true //2016年3月32日は存在しないため、false。 DateUtil.isValid("20160332", "yyyyMMdd"); //--> false
    パラメータ:
    
    date - バリデーション対象日付文字列
    
    format - フォーマット
    
    locale - フォーマットに使用するロケール
    
    戻り値:
    
    dateがformat形式で、実在する日であればtrue
    
    例外:
    
    IllegalArgumentException - dateがnullか、formatがnullまたは空文字の場合

クラス DateUtil

メソッドのサマリー

メソッドの詳細

getDate

formatDate

addDay

addMonth

getDays

getMonths

getMonthEndDate

isValid

isValid