程序包 cn.taketoday.format.datetime

类 DateFormatter

java.lang.Object
cn.taketoday.format.datetime.DateFormatter
所有已实现的接口:
Formatter<Date>, Parser<Date>, Printer<Date>
public class DateFormatter extends Object implements Formatter<Date>
A formatter for Date types.

Supports the configuration of an explicit date time pattern, timezone, locale, and fallback date time patterns for lenient parsing.

从以下版本开始:
4.0
作者:
Keith Donald, Juergen Hoeller, Phillip Webb, Sam Brannen
另请参阅:

  • 构造器详细资料

    • DateFormatter

      public DateFormatter()
      Create a new default DateFormatter.

    • DateFormatter

      public DateFormatter(String pattern)
      Create a new DateFormatter for the given date time pattern.

  • 方法详细资料

    • setSource

      public void setSource(Object source)
      Set the source of the configuration for this DateFormatter — for example, an instance of the @DateTimeFormat annotation if such an annotation was used to configure this DateFormatter.

      The supplied source object will only be used for descriptive purposes by invoking its toString() method — for example, when generating an exception message to provide further context.

      参数:
      source - the source of the configuration

    • setPattern

      public void setPattern(String pattern)
      Set the pattern to use to format date values.

      If not specified, DateFormat's default style will be used.

    • setFallbackPatterns

      public void setFallbackPatterns(String... fallbackPatterns)
      Set additional patterns to use as a fallback in case parsing fails for the configured pattern, ISO format, style, or style pattern.
      参数:
      fallbackPatterns - the fallback parsing patterns
      另请参阅:

    • setIso

      public void setIso(DateTimeFormat.ISO iso)
      Set the ISO format to use to format date values.
      参数:
      iso - the DateTimeFormat.ISO format

    • setStyle

      public void setStyle(int style)
      Set the DateFormat style to use to format date values.

      If not specified, DateFormat's default style will be used.

      另请参阅:

    • setStylePattern

      public void setStylePattern(String stylePattern)
      Set the two characters to use to format date values.

      The first character is used for the date style; the second is used for the time style.

      Supported characters:

      • 'S' = Small
      • 'M' = Medium
      • 'L' = Long
      • 'F' = Full
      • '-' = Omitted
      This method mimics the styles supported by Joda-Time.
      参数:
      stylePattern - two characters from the set {"S", "M", "L", "F", "-"}

    • setTimeZone

      public void setTimeZone(TimeZone timeZone)
      Set the TimeZone to normalize the date values into, if any.

    • setLenient

      public void setLenient(boolean lenient)
      Specify whether or not parsing is to be lenient. Default is false.

      With lenient parsing, the parser may allow inputs that do not precisely match the format. With strict parsing, inputs must match the format exactly.

    • print

      public String print(Date date, Locale locale)
      从接口复制的说明: Printer
      Print the object of type T for display.
      指定者:
      print 在接口中 Printer<Date>
      参数:
      date - the instance to print
      locale - the current user locale
      返回:
      the printed text string

    • parse

      public Date parse(String text, Locale locale) throws ParseException
      从接口复制的说明: Parser
      Parse a text String to produce a T.
      指定者:
      parse 在接口中 Parser<Date>
      参数:
      text - the text string
      locale - the current user locale
      返回:
      an instance of T
      抛出:
      ParseException - when a parse exception occurs in a java.text parsing library

    • getDateFormat

      protected DateFormat getDateFormat(Locale locale)