DateFormatter (Spring Framework API)

java.lang.ObjectSE
- org.springframework.format.datetime.DateFormatter

実装されているすべてのインターフェース:
Formatter<DateSE>, Parser<DateSE>, Printer<DateSE>
```
public class DateFormatter
extends ObjectSE
implements Formatter<DateSE>
```
DateSE 型のフォーマッター。
寛大な解析のために、明示的な日時パターン、タイムゾーン、ロケール、フォールバック日時パターンの構成をサポートします。
UTC インスタントの一般的な ISO パターンは、ミリ秒の精度で適用されます。柔軟な UTC 解析には、代わりに InstantSE への InstantFormatter が推奨されることに注意してください。
導入:
3.0
作成者:
Keith Donald, Juergen Hoeller, Phillip Webb, Sam Brannen
関連事項:
SimpleDateFormatSE

コンストラクターの概要

コンストラクター
コンストラクターと説明
`DateFormatter()` 新しいデフォルトの `DateFormatter` を作成します。
`DateFormatter(StringSE pattern)` 指定された日時パターンに対して新しい `DateFormatter` を作成します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected DateFormatSE`	`getDateFormat(LocaleSE locale)`
`DateSE`	`parse(StringSE text, LocaleSE locale)` テキスト文字列を解析して T を生成します。
`StringSE`	`print(DateSE date, LocaleSE locale)` 型 T のオブジェクトを表示用に出力します。
`void`	`setFallbackPatterns(StringSE... fallbackPatterns)` 構成されたパターン、ISO 形式、style、または style pattern の解析が失敗した場合のフォールバックとして使用するために、追加のパターンを設定します。
`void`	`setIso(DateTimeFormat.ISO iso)` 日付値のフォーマットに使用する ISO フォーマットを設定します。
`void`	`setLenient(boolean lenient)` 解析を寛大にするかどうかを指定します。
`void`	`setPattern(StringSE pattern)` 日付値のフォーマットに使用するパターンを設定します。
`void`	`setSource(ObjectSE source)` この `DateFormatter` の構成のソースを設定します。たとえば、`@DateTimeFormat` アノテーションがこの `DateFormatter` の構成に使用された場合、そのアノテーションのインスタンス。
`void`	`setStyle(int style)` 日付値のフォーマットに使用する `DateFormat`SE スタイルを設定します。
`void`	`setStylePattern(StringSE stylePattern)` 日付値のフォーマットに使用する 2 文字を設定します。
`void`	`setTimeZone(TimeZoneSE timeZone)` `TimeZone`SE を設定して、日付値を正規化します（存在する場合）。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - DateFormatter
```
public DateFormatter()
```
    新しいデフォルトの DateFormatter を作成します。
  - DateFormatter
```
public DateFormatter(StringSE pattern)
```
    指定された日時パターンに対して新しい DateFormatter を作成します。
- メソッドの詳細
  - setSource
```
public void setSource(ObjectSE source)
```
    この DateFormatter の構成のソースを設定します。たとえば、@DateTimeFormat アノテーションがこの DateFormatter の構成に使用された場合、そのアノテーションのインスタンス。
    提供されたソースオブジェクトは、toString() メソッドを呼び出すことによって説明目的でのみ使用されます。たとえば、例外メッセージを生成してさらにコンテキストを提供する場合です。
    パラメーター:
    source - 構成のソース
    導入:
    5.3.5
  - setPattern
```
public void setPattern(StringSE pattern)
```
    日付値のフォーマットに使用するパターンを設定します。
    指定しない場合、DateFormat のデフォルトスタイルが使用されます。
  - setFallbackPatterns
```
public void setFallbackPatterns(StringSE... fallbackPatterns)
```
    構成されたパターン、ISO 形式、style、または style pattern の解析が失敗した場合のフォールバックとして使用するために、追加のパターンを設定します。
    パラメーター:
    fallbackPatterns - フォールバック解析パターン
    導入:
    5.3.5
    関連事項:
    DateTimeFormat.fallbackPatterns()
  - setIso
```
public void setIso(DateTimeFormat.ISO iso)
```
    日付値のフォーマットに使用する ISO フォーマットを設定します。
    パラメーター:
    iso - DateTimeFormat.ISO フォーマット
    導入:
    3.2
  - setStyle
```
public void setStyle(int style)
```
    日付値のフォーマットに使用する DateFormatSE スタイルを設定します。
    指定しない場合、DateFormat のデフォルトスタイルが使用されます。
    関連事項:
    DateFormat.DEFAULTSE, DateFormat.SHORTSE, DateFormat.MEDIUMSE, DateFormat.LONGSE, DateFormat.FULLSE
  - setStylePattern
```
public void setStylePattern(StringSE stylePattern)
```
    日付値のフォーマットに使用する 2 文字を設定します。
    最初の文字は日付スタイルに使用されます。2 番目は時間スタイルに使用されます。
    サポートされている文字:
    - 'S' = 小
    - 'M' = 中
    - 'L' = 長い
    - 'F' = フル
    - '-' = 省略
    このメソッドは、Joda-Time がサポートするスタイルを模倣しています。
    パラメーター:
    stylePattern - セット {"S"、"M"、"L"、"F"、"-"} の 2 文字
    導入:
    3.2
  - setTimeZone
```
public void setTimeZone(TimeZoneSE timeZone)
```
    TimeZoneSE を設定して、日付値を正規化します（存在する場合）。
  - setLenient
```
public void setLenient(boolean lenient)
```
    解析を寛大にするかどうかを指定します。デフォルトは false です。
    緩やかな解析では、パーサーは形式に正確に一致しない入力を許可する場合があります。厳密な解析では、入力は形式と正確に一致する必要があります。
  - print
```
public StringSE print(DateSE date,
                    LocaleSE locale)
```
    インターフェースからコピーされた説明: Printer
    型 T のオブジェクトを表示用に出力します。
    次で指定:
    インターフェース Printer<DateSE> の print
    パラメーター:
    date - 出力するインスタンス
    locale - 現在のユーザーロケール
    戻り値:
    出力されたテキスト文字列
  - parse
```
public DateSE parse(StringSE text,
                  LocaleSE locale)
           throws ParseExceptionSE
```
    インターフェースからコピーされた説明: Parser
    テキスト文字列を解析して T を生成します。
    次で指定:
    インターフェース Parser<DateSE> の parse
    パラメーター:
    text - テキスト文字列
    locale - 現在のユーザーロケール
    戻り値:
    T のインスタンス
    例外:
    ParseExceptionSE - java.text 解析ライブラリで解析例外が発生したとき
  - getDateFormat
```
protected DateFormatSE getDateFormat(LocaleSE locale)
```

クラス DateFormatter

コンストラクターの概要

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

DateFormatter

DateFormatter

メソッドの詳細

setSource

setPattern

setFallbackPatterns

setIso

setStyle

setStylePattern

setTimeZone

setLenient

print

parse

getDateFormat