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