com.github.jarvisframework.tool.core.date.format

类 FormatCache<F extends Format>

java.lang.Object

com.github.jarvisframework.tool.core.date.format.FormatCache<F>

abstract class FormatCache<F extends Format>
extends Object

日期格式化器缓存
Thanks to Apache Commons Lang 3.5

从以下版本开始:

1.0, 2020-07-23 15:44:38

作者:

Doug Wang

字段概要

字段

限定符和类型	字段和说明
private static ConcurrentMap<Tuple,String>	cDateTimeInstanceCache
private ConcurrentMap<Tuple,F>	cInstanceCache
(专用程序包) static int	NONE No date or no time.

构造器概要

构造器

构造器和说明
FormatCache()

方法概要

限定符和类型	方法和说明
protected abstract F	createInstance(String pattern, TimeZone timeZone, Locale locale) 创建格式化器
(专用程序包) F	getDateInstance(int dateStyle, TimeZone timeZone, Locale locale) Gets a date 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	getDateTimeInstance(int dateStyle, int timeStyle, TimeZone timeZone, Locale locale) Gets a date/time formatter instance using the specified style, time zone and locale.
F	getInstance() 使用默认的pattern、timezone和locale获得缓存中的实例
F	getInstance(String pattern, TimeZone timeZone, Locale locale) 使用 pattern, time zone and locale 获得对应的 格式化器
(专用程序包) static String	getPatternForStyle(Integer dateStyle, Integer timeStyle, Locale locale) Gets a date/time format for the specified styles and locale.
(专用程序包) F	getTimeInstance(int timeStyle, TimeZone timeZone, Locale locale) Gets a time formatter instance using the specified style, time zone and locale.

从类继承的方法 java.lang.Object

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

字段详细资料

NONE

static final int NONE

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

另请参阅:

常量字段值

cInstanceCache

private final ConcurrentMap<Tuple,F extends Format> cInstanceCache

cDateTimeInstanceCache

private static final ConcurrentMap<Tuple,String> cDateTimeInstanceCache

构造器详细资料

FormatCache

FormatCache()

方法详细资料

getInstance

public F getInstance()

使用默认的pattern、timezone和locale获得缓存中的实例

返回:

a date/time formatter

getInstance

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

使用 pattern, time zone and locale 获得对应的 格式化器

参数:

pattern - 非空日期格式，使用与 SimpleDateFormat相同格式

timeZone - 时区，默认当前时区

locale - 地区，默认使用当前地区

返回:

格式化器

抛出:

IllegalArgumentException - pattern 无效或null

createInstance

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

创建格式化器

参数:

pattern - 非空日期格式，使用与 SimpleDateFormat相同格式

timeZone - 时区，默认当前时区

locale - 地区，默认使用当前地区

返回:

格式化器

抛出:

IllegalArgumentException - pattern 无效或null

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.

参数:

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

返回:

a localized standard date/time formatter

抛出:

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.

参数:

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

返回:

a localized standard date/time formatter

抛出:

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

getDateInstance

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

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

参数:

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

返回:

a localized standard date/time formatter

抛出:

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

getTimeInstance

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

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

参数:

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

返回:

a localized standard date/time formatter

抛出:

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

getPatternForStyle

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

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

参数:

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

返回:

a localized standard date/time format

抛出:

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