Field Detail

• DATE_FORMAT_STR_ISO8601

  public static final String DATE_FORMAT_STR_ISO8601

  Defines a commonly used date format that conforms to ISO-8601 date formatting standard, when it includes basic undecorated timezone definition

  See Also:

  Constant Field Values

• DATE_FORMAT_STR_ISO8601_Z

  protected static final String DATE_FORMAT_STR_ISO8601_Z

  Same as 'regular' 8601, but handles 'Z' as an alias for "+0000" (or "UTC")

  See Also:

  Constant Field Values

• DATE_FORMAT_STR_PLAIN

  protected static final String DATE_FORMAT_STR_PLAIN

  ISO-8601 with just the Date part, no time

  See Also:

  Constant Field Values

• DATE_FORMAT_STR_RFC1123

  protected static final String DATE_FORMAT_STR_RFC1123

  This constant defines the date format specified by RFC 1123 / RFC 822.

  See Also:

  Constant Field Values

• ALL_FORMATS

  protected static final String[] ALL_FORMATS

  For error messages we'll also need a list of all formats.

• DATE_FORMAT_RFC1123

  protected static final DateFormat DATE_FORMAT_RFC1123

• DATE_FORMAT_ISO8601

  protected static final DateFormat DATE_FORMAT_ISO8601

• DATE_FORMAT_ISO8601_Z

  protected static final DateFormat DATE_FORMAT_ISO8601_Z

• DATE_FORMAT_PLAIN

  protected static final DateFormat DATE_FORMAT_PLAIN

• instance

  public static final StdDateFormat instance

  A singleton instance can be used for cloning purposes, as a blueprint of sorts.

• _timezone

  protected transient TimeZone _timezone

  Caller may want to explicitly override timezone to use; if so, we will have non-null value here.

• _locale

  protected final Locale _locale

• _lenient

  protected Boolean _lenient

  Explicit override for leniency, if specified.

  Can not be `final` because setLenient(boolean) returns `void`.

  Since:

  2.7

• _formatRFC1123

  protected transient DateFormat _formatRFC1123

• _formatISO8601

  protected transient DateFormat _formatISO8601

• _formatISO8601_z

  protected transient DateFormat _formatISO8601_z

• _formatPlain

  protected transient DateFormat _formatPlain

Constructor Detail

• StdDateFormat

  public StdDateFormat()

• StdDateFormat

  @Deprecated
  public StdDateFormat(TimeZone tz,
                          Locale loc)

  Deprecated. 

• StdDateFormat

  protected StdDateFormat(TimeZone tz,
               Locale loc,
               Boolean lenient)

Method Detail

• getDefaultTimeZone

  public static TimeZone getDefaultTimeZone()

• withTimeZone

  public StdDateFormat withTimeZone(TimeZone tz)

  Method used for creating a new instance with specified timezone; if no timezone specified, defaults to the default timezone (UTC).

• withLocale

  public StdDateFormat withLocale(Locale loc)

• clone

  public StdDateFormat clone()

  Overrides:

  clone in class DateFormat

• getISO8601Format

  @Deprecated
  public static DateFormat getISO8601Format(TimeZone tz)

  Deprecated. Since 2.4; use variant that takes Locale

• getISO8601Format

  public static DateFormat getISO8601Format(TimeZone tz,
                            Locale loc)

  Method for getting a non-shared DateFormat instance that uses specified timezone and can handle simple ISO-8601 compliant date format.

  Since:

  2.4

• getRFC1123Format

  public static DateFormat getRFC1123Format(TimeZone tz,
                            Locale loc)

  Method for getting a non-shared DateFormat instance that uses specific timezone and can handle RFC-1123 compliant date format.

  Since:

  2.4

• getRFC1123Format

  @Deprecated
  public static DateFormat getRFC1123Format(TimeZone tz)

  Deprecated. Since 2.4; use variant that takes Locale

• getTimeZone

  public TimeZone getTimeZone()

  Overrides:

  getTimeZone in class DateFormat

• setTimeZone

  public void setTimeZone(TimeZone tz)

  Overrides:

  setTimeZone in class DateFormat

• setLenient

  public void setLenient(boolean enabled)

  Need to override since we need to keep track of leniency locally, and not via underlying Calendar instance like base class does.

  Overrides:

  setLenient in class DateFormat

• isLenient

  public boolean isLenient()

  Overrides:

  isLenient in class DateFormat

• parse

  public Date parse(String dateStr)
             throws ParseException

  Overrides:

  parse in class DateFormat

  Throws:

  ParseException

• parse

  public Date parse(String dateStr,
           ParsePosition pos)

  Specified by:

  parse in class DateFormat

• format

  public StringBuffer format(Date date,
                    StringBuffer toAppendTo,
                    FieldPosition fieldPosition)

  Specified by:

  format in class DateFormat

• toString

  public String toString()

  Overrides:

  toString in class Object

• equals

  public boolean equals(Object o)

  Overrides:

  equals in class DateFormat

• hashCode

  public int hashCode()

  Overrides:

  hashCode in class DateFormat

• looksLikeISO8601

  protected boolean looksLikeISO8601(String dateStr)

  Overridable helper method used to figure out which of supported formats is the likeliest match.

• parseAsISO8601

  protected Date parseAsISO8601(String dateStr,
                    ParsePosition pos,
                    boolean throwErrors)
                         throws ParseException

  Throws:

  ParseException

• parseAsRFC1123

  protected Date parseAsRFC1123(String dateStr,
                    ParsePosition pos)

• _clearFormats

  protected void _clearFormats()