パッケージ org.springframework.format.datetime

クラス DateFormatter

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
関連事項:

  • コンストラクターの詳細

    • 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
      関連事項:

    • setIso

      public void setIso(DateTimeFormat.ISO iso)
      日付値のフォーマットに使用する ISO フォーマットを設定します。
      パラメーター:
      iso - DateTimeFormat.ISO フォーマット
      導入:
      3.2

    • setStyle

      public void setStyle(int style)
      日付値のフォーマットに使用する DateFormatSE スタイルを設定します。

      指定しない場合、DateFormat のデフォルトスタイルが使用されます。

      関連事項:

    • 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)