cz.auderis.tools.time

Class ThreadLocalDateFormat

java.lang.Object

java.text.Format

java.text.DateFormat

cz.auderis.tools.time.ThreadLocalDateFormat

All Implemented Interfaces:

Serializable, Cloneable

public class ThreadLocalDateFormat
extends DateFormat

ThreadLocalDateFormat simplifies handling of SimpleDateFormat in concurrent, multi-threaded environments. This class serves as a thin wrapper that delegates formatting and parsing tasks to thread-local instances.

Version:

1.0

Author:

Boleslav Bobcik <bbobcik@gmail.com>

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.text.DateFormat

DateFormat.Field

Field Summary

Fields

Modifier and Type	Field and Description
static String	ISO_FORMAT_MASK Default format template used when default constructor is invoked.

Fields inherited from class java.text.DateFormat

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

Constructor Summary

Constructors

Constructor and Description
ThreadLocalDateFormat() Creates a new instance using ISO_FORMAT_MASK formatting template.
ThreadLocalDateFormat(String template) Creates a new instance using the provided formatting template for the underlying SimpleDateFormat.
ThreadLocalDateFormat(String template, Locale locale) Creates a new instance using the provided formatting template and non-default Locale for the underlying SimpleDateFormat.

Method Summary

Modifier and Type	Method and Description
ThreadLocalDateFormat	clone()
StringBuffer	format(Date date, StringBuffer toAppendTo, FieldPosition pos)
Date	parse(String source, ParsePosition pos)

Methods inherited from class java.text.DateFormat

equals, format, format, getAvailableLocales, getCalendar, getDateInstance, getDateInstance, getDateInstance, getDateTimeInstance, getDateTimeInstance, getDateTimeInstance, getInstance, getNumberFormat, getTimeInstance, getTimeInstance, getTimeInstance, getTimeZone, hashCode, isLenient, parse, parseObject, setCalendar, setLenient, setNumberFormat, setTimeZone

Methods inherited from class java.text.Format

format, formatToCharacterIterator, parseObject

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

ISO_FORMAT_MASK

public static final String ISO_FORMAT_MASK

Default format template used when default constructor is invoked.

See Also:

Constant Field Values

Constructor Detail

ThreadLocalDateFormat

public ThreadLocalDateFormat()

Creates a new instance using ISO_FORMAT_MASK formatting template.

ThreadLocalDateFormat

public ThreadLocalDateFormat(String template)

Creates a new instance using the provided formatting template for the underlying SimpleDateFormat.

Parameters:

template - format template

ThreadLocalDateFormat

public ThreadLocalDateFormat(String template,
                             Locale locale)

Creates a new instance using the provided formatting template and non-default Locale for the underlying SimpleDateFormat.

Parameters:

template - format template

locale - locale to be used

Method Detail

format

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

Specified by:

format in class DateFormat

parse

public Date parse(String source,
                  ParsePosition pos)

Specified by:

parse in class DateFormat

clone

public ThreadLocalDateFormat clone()

Overrides:

clone in class DateFormat