Package org.sqlite.date

Class FastDateParser

  • All Implemented Interfaces:
    Serializable, DateParser
    public class FastDateParser
extends Object
implements DateParser, Serializable
    FastDateParser is a fast and thread-safe version of SimpleDateFormat.

    To obtain a proxy to a FastDateParser, use FastDateFormat.getInstance(String, TimeZone, Locale) or another variation of the factory methods of FastDateFormat.

    Since FastDateParser is thread safe, you can use a static member instance: private static final DateParser DATE_PARSER = FastDateFormat.getInstance("yyyy-MM-dd");

    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 has closed the bug/RFE.

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

    The class operates in lenient mode, so for example a time of 90 minutes is treated as 1 hour 30 minutes.

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

    Since:
    3.2
    Version:
    $Id$
    See Also:
    FastDatePrinter, Serialized Form

    • Constructor Detail

      • FastDateParser

        protected FastDateParser​(String pattern,
                         TimeZone timeZone,
                         Locale locale,
                         Date centuryStart)
        Constructs a new FastDateParser.
        Parameters:
        pattern - non-null SimpleDateFormat compatible pattern
        timeZone - non-null time zone to use
        locale - non-null locale
        centuryStart - The start of the century for 2 digit year parsing
        Since:
        3.3

    • Method Detail

      • getTimeZone

        public 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 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​(Object obj)
        Compare another object for equality with this object.
        Overrides:
        equals in class 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 Object
        Returns:
        a hashcode compatible with equals

      • toString

        public String toString()
        Get a string version of this formatter.
        Overrides:
        toString in class Object
        Returns:
        a debugging string

      • parse

        public Date parse​(String source)
           throws 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:
        ParseException - if the beginning of the specified string cannot be parsed.

      • parse

        public Date parse​(String source,
                  ParsePosition pos)
        This implementation updates the ParsePosition if the parse succeeds. However, unlike the method SimpleDateFormat.parse(String, ParsePosition) it is not able to set the error Index - i.e. ParsePosition.getErrorIndex() - if the parse fails.

        To determine if the parse has succeeded, the caller must check if the current parse position given by ParsePosition.getIndex() has been updated. If the input buffer has been fully parsed, then the index will point to just after the end of the input buffer.

        See org.apache.commons.lang3.time.DateParser#parse(java.lang.String, java.text.ParsePosition) 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.