public class StdDateFormat
extends java.text.DateFormat
DateFormat
implementation used by standard Date
serializers and deserializers. For serialization defaults to using
an ISO-8601 compliant format (format String "yyyy-MM-dd'T'HH:mm:ss.SSSZ")
and for deserialization, both ISO-8601 and RFC-1123.Modifier and Type | Field and Description |
---|---|
protected java.text.DateFormat |
_formatISO8601 |
protected java.text.DateFormat |
_formatISO8601_z |
protected java.text.DateFormat |
_formatPlain |
protected java.text.DateFormat |
_formatRFC1123 |
protected java.lang.Boolean |
_lenient
Explicit override for leniency, if specified.
|
protected java.util.Locale |
_locale |
protected java.util.TimeZone |
_timezone
Caller may want to explicitly override timezone to use; if so,
we will have non-null value here.
|
protected static java.lang.String[] |
ALL_FORMATS
For error messages we'll also need a list of all formats.
|
protected static java.text.DateFormat |
DATE_FORMAT_ISO8601 |
protected static java.text.DateFormat |
DATE_FORMAT_ISO8601_Z |
protected static java.text.DateFormat |
DATE_FORMAT_PLAIN |
protected static java.text.DateFormat |
DATE_FORMAT_RFC1123 |
static java.lang.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
|
protected static java.lang.String |
DATE_FORMAT_STR_ISO8601_Z
Same as 'regular' 8601, but handles 'Z' as an alias for "+0000"
(or "UTC")
|
protected static java.lang.String |
DATE_FORMAT_STR_PLAIN
ISO-8601 with just the Date part, no time
|
protected static java.lang.String |
DATE_FORMAT_STR_RFC1123
This constant defines the date format specified by
RFC 1123 / RFC 822.
|
private static java.util.Locale |
DEFAULT_LOCALE |
private static java.util.TimeZone |
DEFAULT_TIMEZONE
By default we use UTC for everything, with Jackson 2.7 and later
(2.6 and earlier relied on GMT)
|
static StdDateFormat |
instance
A singleton instance can be used for cloning purposes, as a blueprint of sorts.
|
AM_PM_FIELD, calendar, DATE_FIELD, DAY_OF_WEEK_FIELD, DAY_OF_WEEK_IN_MONTH_FIELD, DAY_OF_YEAR_FIELD, DEFAULT, ERA_FIELD, FULL, HOUR_OF_DAY0_FIELD, HOUR_OF_DAY1_FIELD, HOUR0_FIELD, HOUR1_FIELD, LONG, MEDIUM, MILLISECOND_FIELD, MINUTE_FIELD, MONTH_FIELD, numberFormat, SECOND_FIELD, SHORT, TIMEZONE_FIELD, WEEK_OF_MONTH_FIELD, WEEK_OF_YEAR_FIELD, YEAR_FIELD
Modifier | Constructor and Description |
---|---|
|
StdDateFormat() |
|
StdDateFormat(java.util.TimeZone tz,
java.util.Locale loc)
Deprecated.
|
protected |
StdDateFormat(java.util.TimeZone tz,
java.util.Locale loc,
java.lang.Boolean lenient) |
Modifier and Type | Method and Description |
---|---|
protected void |
_clearFormats() |
private static java.text.DateFormat |
_cloneFormat(java.text.DateFormat df,
java.lang.String format,
java.util.TimeZone tz,
java.util.Locale loc,
java.lang.Boolean lenient) |
StdDateFormat |
clone() |
boolean |
equals(java.lang.Object o) |
java.lang.StringBuffer |
format(java.util.Date date,
java.lang.StringBuffer toAppendTo,
java.text.FieldPosition fieldPosition) |
static java.util.TimeZone |
getDefaultTimeZone() |
static java.text.DateFormat |
getISO8601Format(java.util.TimeZone tz)
Deprecated.
Since 2.4; use variant that takes Locale
|
static java.text.DateFormat |
getISO8601Format(java.util.TimeZone tz,
java.util.Locale loc)
Method for getting a non-shared DateFormat instance
that uses specified timezone and can handle simple ISO-8601
compliant date format.
|
static java.text.DateFormat |
getRFC1123Format(java.util.TimeZone tz)
Deprecated.
Since 2.4; use variant that takes Locale
|
static java.text.DateFormat |
getRFC1123Format(java.util.TimeZone tz,
java.util.Locale loc)
Method for getting a non-shared DateFormat instance
that uses specific timezone and can handle RFC-1123
compliant date format.
|
java.util.TimeZone |
getTimeZone() |
int |
hashCode() |
private static boolean |
hasTimeZone(java.lang.String str) |
boolean |
isLenient() |
protected boolean |
looksLikeISO8601(java.lang.String dateStr)
Overridable helper method used to figure out which of supported
formats is the likeliest match.
|
java.util.Date |
parse(java.lang.String dateStr) |
java.util.Date |
parse(java.lang.String dateStr,
java.text.ParsePosition pos) |
protected java.util.Date |
parseAsISO8601(java.lang.String dateStr,
java.text.ParsePosition pos,
boolean throwErrors) |
protected java.util.Date |
parseAsRFC1123(java.lang.String dateStr,
java.text.ParsePosition pos) |
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. |
void |
setTimeZone(java.util.TimeZone tz) |
java.lang.String |
toString() |
StdDateFormat |
withLocale(java.util.Locale loc) |
StdDateFormat |
withTimeZone(java.util.TimeZone tz)
Method used for creating a new instance with specified timezone;
if no timezone specified, defaults to the default timezone (UTC).
|
format, format, getAvailableLocales, getCalendar, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getNumberFormat, getTimeInstance, getTimeInstance, getTimeInstance, parseObject, setCalendar, setNumberFormat
public static final java.lang.String DATE_FORMAT_STR_ISO8601
protected static final java.lang.String DATE_FORMAT_STR_ISO8601_Z
protected static final java.lang.String DATE_FORMAT_STR_PLAIN
protected static final java.lang.String DATE_FORMAT_STR_RFC1123
protected static final java.lang.String[] ALL_FORMATS
private static final java.util.TimeZone DEFAULT_TIMEZONE
private static final java.util.Locale DEFAULT_LOCALE
protected static final java.text.DateFormat DATE_FORMAT_RFC1123
protected static final java.text.DateFormat DATE_FORMAT_ISO8601
protected static final java.text.DateFormat DATE_FORMAT_ISO8601_Z
protected static final java.text.DateFormat DATE_FORMAT_PLAIN
public static final StdDateFormat instance
protected transient java.util.TimeZone _timezone
protected final java.util.Locale _locale
protected java.lang.Boolean _lenient
Can not be `final` because setLenient(boolean)
returns
`void`.
protected transient java.text.DateFormat _formatRFC1123
protected transient java.text.DateFormat _formatISO8601
protected transient java.text.DateFormat _formatISO8601_z
protected transient java.text.DateFormat _formatPlain
public StdDateFormat()
@Deprecated public StdDateFormat(java.util.TimeZone tz, java.util.Locale loc)
protected StdDateFormat(java.util.TimeZone tz, java.util.Locale loc, java.lang.Boolean lenient)
public static java.util.TimeZone getDefaultTimeZone()
public StdDateFormat withTimeZone(java.util.TimeZone tz)
public StdDateFormat withLocale(java.util.Locale loc)
public StdDateFormat clone()
clone
in class java.text.DateFormat
@Deprecated public static java.text.DateFormat getISO8601Format(java.util.TimeZone tz)
public static java.text.DateFormat getISO8601Format(java.util.TimeZone tz, java.util.Locale loc)
public static java.text.DateFormat getRFC1123Format(java.util.TimeZone tz, java.util.Locale loc)
@Deprecated public static java.text.DateFormat getRFC1123Format(java.util.TimeZone tz)
public java.util.TimeZone getTimeZone()
getTimeZone
in class java.text.DateFormat
public void setTimeZone(java.util.TimeZone tz)
setTimeZone
in class java.text.DateFormat
public void setLenient(boolean enabled)
Calendar
instance like base class
does.setLenient
in class java.text.DateFormat
public boolean isLenient()
isLenient
in class java.text.DateFormat
public java.util.Date parse(java.lang.String dateStr) throws java.text.ParseException
parse
in class java.text.DateFormat
java.text.ParseException
public java.util.Date parse(java.lang.String dateStr, java.text.ParsePosition pos)
parse
in class java.text.DateFormat
public java.lang.StringBuffer format(java.util.Date date, java.lang.StringBuffer toAppendTo, java.text.FieldPosition fieldPosition)
format
in class java.text.DateFormat
public java.lang.String toString()
toString
in class java.lang.Object
public boolean equals(java.lang.Object o)
equals
in class java.text.DateFormat
public int hashCode()
hashCode
in class java.text.DateFormat
protected boolean looksLikeISO8601(java.lang.String dateStr)
protected java.util.Date parseAsISO8601(java.lang.String dateStr, java.text.ParsePosition pos, boolean throwErrors) throws java.text.ParseException
java.text.ParseException
protected java.util.Date parseAsRFC1123(java.lang.String dateStr, java.text.ParsePosition pos)
private static final boolean hasTimeZone(java.lang.String str)
private static final java.text.DateFormat _cloneFormat(java.text.DateFormat df, java.lang.String format, java.util.TimeZone tz, java.util.Locale loc, java.lang.Boolean lenient)
protected void _clearFormats()