Package org.apache.commons.lang3.time

Class AbstractFormatCache<F extends Format>

java.lang.Object

org.apache.commons.lang3.time.AbstractFormatCache<F>

Type Parameters:

F - The Format type.

abstract class AbstractFormatCache<F extends Format>
extends Object

FormatCache is a cache and factory for Formats.

Since:

3.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	AbstractFormatCache.ArrayKey	Helper class to hold multipart Map keys as arrays.

Field Summary

Fields

Modifier and Type	Field	Description
private static final ConcurrentMap<AbstractFormatCache.ArrayKey,String>	cDateTimeInstanceCache
private final ConcurrentMap<AbstractFormatCache.ArrayKey,F>	cInstanceCache
(package private) static final int	NONE	No date or no time.

Constructor Summary

Constructors

Constructor	Description
AbstractFormatCache()

Method Summary

Modifier and Type	Method	Description
protected abstract F	createInstance(String pattern, TimeZone timeZone, Locale locale)	Create a format instance using the specified pattern, time zone and locale.
(package private) F	getDateInstance(int dateStyle, TimeZone timeZone, Locale locale)	Gets a date formatter instance using the specified style, time zone and locale.
(package private) F	getDateTimeInstance(int dateStyle, int timeStyle, TimeZone timeZone, Locale locale)	Gets a date/time formatter instance using the specified style, time zone and locale.
private F	getDateTimeInstance(Integer dateStyle, Integer timeStyle, TimeZone timeZone, Locale locale)	Gets a date/time formatter instance using the specified style, time zone and locale.
F	getInstance()	Gets a formatter instance using the default pattern in the default time zone and locale.
F	getInstance(String pattern, TimeZone timeZone, Locale locale)	Gets a formatter instance using the specified pattern, time zone and locale.
(package private) static String	getPatternForStyle(Integer dateStyle, Integer timeStyle, Locale locale)	Gets a date/time format for the specified styles and locale.
(package private) F	getTimeInstance(int timeStyle, TimeZone timeZone, Locale locale)	Gets a time formatter instance using the specified style, time zone and locale.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

NONE

static final int NONE

No date or no time. Used in same parameters as DateFormat.SHORT or DateFormat.LONG

See Also:

• Constant Field Values

cDateTimeInstanceCache

private static final ConcurrentMap<AbstractFormatCache.ArrayKey,String> cDateTimeInstanceCache

cInstanceCache

private final ConcurrentMap<AbstractFormatCache.ArrayKey,F extends Format> cInstanceCache

Constructor Details

AbstractFormatCache

AbstractFormatCache()

Method Details

getPatternForStyle

static String getPatternForStyle(Integer dateStyle,
 Integer timeStyle,
 Locale locale)

Gets a date/time format for the specified styles and locale.

Parameters:

dateStyle - date style: FULL, LONG, MEDIUM, or SHORT, null indicates no date in format

timeStyle - time style: FULL, LONG, MEDIUM, or SHORT, null indicates no time in format

locale - The non-null locale of the desired format

Returns:

a localized standard date/time format

Throws:

IllegalArgumentException - if the Locale has no date/time pattern defined

createInstance

protected abstract F createInstance(String pattern,
 TimeZone timeZone,
 Locale locale)

Create a format instance using the specified pattern, time zone and locale.

Parameters:

pattern - SimpleDateFormat compatible pattern, this will not be null.

timeZone - time zone, this will not be null.

locale - locale, this will not be null.

Returns:

a pattern based date/time formatter

Throws:

IllegalArgumentException - if pattern is invalid or null

getDateInstance

F getDateInstance(int dateStyle,
 TimeZone timeZone,
 Locale locale)

Gets a date formatter instance using the specified style, time zone and locale.

Parameters:

dateStyle - date style: FULL, LONG, MEDIUM, or SHORT

timeZone - optional time zone, overrides time zone of formatted date, null means use default Locale

locale - optional locale, overrides system locale

Returns:

a localized standard date/time formatter

Throws:

IllegalArgumentException - if the Locale has no date/time pattern defined

getDateTimeInstance

F getDateTimeInstance(int dateStyle,
 int timeStyle,
 TimeZone timeZone,
 Locale locale)

Gets a date/time formatter instance using the specified style, time zone and locale.

Parameters:

dateStyle - date style: FULL, LONG, MEDIUM, or SHORT

timeStyle - time style: FULL, LONG, MEDIUM, or SHORT

timeZone - optional time zone, overrides time zone of formatted date, null means use default Locale

locale - optional locale, overrides system locale

Returns:

a localized standard date/time formatter

Throws:

IllegalArgumentException - if the Locale has no date/time pattern defined

getDateTimeInstance

private F getDateTimeInstance(Integer dateStyle,
 Integer timeStyle,
 TimeZone timeZone,
 Locale locale)

Gets a date/time formatter instance using the specified style, time zone and locale.

Parameters:

dateStyle - date style: FULL, LONG, MEDIUM, or SHORT, null indicates no date in format

timeStyle - time style: FULL, LONG, MEDIUM, or SHORT, null indicates no time in format

timeZone - optional time zone, overrides time zone of formatted date, null means use default Locale

locale - optional locale, overrides system locale

Returns:

a localized standard date/time formatter

Throws:

IllegalArgumentException - if the Locale has no date/time pattern defined

getInstance

public F getInstance()

Gets a formatter instance using the default pattern in the default time zone and locale.

Returns:

a date/time formatter

getInstance

public F getInstance(String pattern,
 TimeZone timeZone,
 Locale locale)

Gets a formatter instance using the specified pattern, time zone and locale.

Parameters:

pattern - SimpleDateFormat compatible pattern, non-null

timeZone - the time zone, null means use the default TimeZone

locale - the locale, null means use the default Locale

Returns:

a pattern based date/time formatter

Throws:

NullPointerException - if pattern is null

IllegalArgumentException - if pattern is invalid

getTimeInstance

F getTimeInstance(int timeStyle,
 TimeZone timeZone,
 Locale locale)

Gets a time formatter instance using the specified style, time zone and locale.

Parameters:

timeStyle - time style: FULL, LONG, MEDIUM, or SHORT

timeZone - optional time zone, overrides time zone of formatted date, null means use default Locale

locale - optional locale, overrides system locale

Returns:

a localized standard date/time formatter

Throws:

IllegalArgumentException - if the Locale has no date/time pattern defined