org.apache.commons.lang3.time

Class FastDateParser

java.lang.Object

org.apache.commons.lang3.time.FastDateParser

All Implemented Interfaces:

java.io.Serializable, DateParser

public class FastDateParser
extends java.lang.Object
implements DateParser, java.io.Serializable

FastDateParser is a fast and thread-safe version of SimpleDateFormat.

This class can be used as a direct replacement for SimpleDateFormat in most parsing situations. This class is especially useful in multi-threaded server environments. SimpleDateFormat is not thread-safe in any JDK version, nor will it be as Sun have closed the bug/RFE.

Only parsing is supported, but all patterns are compatible with SimpleDateFormat.

Timing tests indicate this class is as about as fast as SimpleDateFormat in single thread applications and about 25% faster in multi-thread applications.

Note that the code only handles Gregorian calendars. The following non-Gregorian calendars use SimpleDateFormat internally, and so will be slower:

• ja_JP_TH - Japanese Imperial
• th_TH (any variant) - Thai Buddhist

Since:

3.2

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Compare another object for equality with this object.
java.util.Locale	getLocale() Get the locale used by this parser.
java.lang.String	getPattern() Get the pattern used by this parser.
java.util.TimeZone	getTimeZone() Get the time zone used by this parser.
int	hashCode() Return a hashcode compatible with equals.
java.util.Date	parse(java.lang.String source) Equivalent to DateFormat.parse(String).
java.util.Date	parse(java.lang.String source, java.text.ParsePosition pos) Equivalent to DateFormat.parse(String, ParsePosition).
java.lang.Object	parseObject(java.lang.String source) Parses text from a string to produce a Date.
java.lang.Object	parseObject(java.lang.String source, java.text.ParsePosition pos) Parse a date/time string according to the given parse position.
java.lang.String	toString() Get a string version of this formatter.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

getPattern

public java.lang.String getPattern()

Description copied from interface: DateParser

Get the pattern used by this parser.

Specified by:

getPattern in interface DateParser

Returns:

the pattern, SimpleDateFormat compatible

getTimeZone

public java.util.TimeZone getTimeZone()

Description copied from interface: DateParser

Get the time zone used by this parser.

The default TimeZone used to create a Date when the TimeZone is not specified by the format pattern.

Specified by:

getTimeZone in interface DateParser

Returns:

the time zone

getLocale

public java.util.Locale getLocale()

Description copied from interface: DateParser

Get the locale used by this parser.

Specified by:

getLocale in interface DateParser

Returns:

the locale

equals

public boolean equals(java.lang.Object obj)

Compare another object for equality with this object.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to compare to

Returns:

trueif equal to this instance

hashCode

public int hashCode()

Return a hashcode compatible with equals.

Overrides:

hashCode in class java.lang.Object

Returns:

a hashcode compatible with equals

toString

public java.lang.String toString()

Get a string version of this formatter.

Overrides:

toString in class java.lang.Object

Returns:

a debugging string

parseObject

public java.lang.Object parseObject(java.lang.String source)
                             throws java.text.ParseException

Description copied from interface: DateParser

Parses text from a string to produce a Date.

Specified by:

parseObject in interface DateParser

Parameters:

source - A String whose beginning should be parsed.

Returns:

a java.util.Date object

Throws:

java.text.ParseException - if the beginning of the specified string cannot be parsed.

See Also:

Format.parseObject(String)

parse

public java.util.Date parse(java.lang.String source)
                     throws java.text.ParseException

Description copied from interface: DateParser

Equivalent to DateFormat.parse(String). See DateFormat.parse(String) for more information.

Specified by:

parse in interface DateParser

Parameters:

source - A String whose beginning should be parsed.

Returns:

A Date parsed from the string

Throws:

java.text.ParseException - if the beginning of the specified string cannot be parsed.

parseObject

public java.lang.Object parseObject(java.lang.String source,
                                    java.text.ParsePosition pos)

Description copied from interface: DateParser

Parse a date/time string according to the given parse position.

Specified by:

parseObject in interface DateParser

Parameters:

source - A String whose beginning should be parsed.

pos - the parse position

Returns:

a java.util.Date object

See Also:

DateFormat.parseObject(String, ParsePosition)

parse

public java.util.Date parse(java.lang.String source,
                            java.text.ParsePosition pos)

Description copied from interface: DateParser

Equivalent to DateFormat.parse(String, ParsePosition). See DateFormat.parse(String, ParsePosition) for more information.

Specified by:

parse in interface DateParser

Parameters:

source - A String, part of which should be parsed.

pos - A ParsePosition object with index and error index information as described above.

Returns:

A Date parsed from the string. In case of error, returns null.