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

类 FastDatePrinter

java.lang.Object

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

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

所有已实现的接口:

DateBasic, DatePrinter, Serializable

class FastDatePrinter
extends AbstractDateBasic
implements DatePrinter

SimpleDateFormat 的线程安全版本，用于将 Date 格式化输出
Thanks to Apache Commons Lang 3.5

从以下版本开始:

1.0, 2020-07-24 15:55:14

作者:

Doug Wang

嵌套类概要

嵌套类

限定符和类型	类和说明
private static class	FastDatePrinter.CharacterLiteral Inner class to output a constant single character.
private static class	FastDatePrinter.DayInWeekField Inner class to output the numeric day in week.
private static class	FastDatePrinter.Iso8601_Rule Inner class to output a time zone as a number +/-HHMM or +/-HH:MM.
private static interface	FastDatePrinter.NumberRule Inner class defining a numeric rule.
private static class	FastDatePrinter.PaddedNumberField Inner class to output a padded number.
private static interface	FastDatePrinter.Rule 规则
private static class	FastDatePrinter.StringLiteral Inner class to output a constant string.
private static class	FastDatePrinter.TextField Inner class to output one of a set of values.
private static class	FastDatePrinter.TimeZoneDisplayKey Inner class that acts as a compound key for time zone names.
private static class	FastDatePrinter.TimeZoneNameRule Inner class to output a time zone name.
private static class	FastDatePrinter.TimeZoneNumberRule Inner class to output a time zone as a number +/-HHMM or +/-HH:MM.
private static class	FastDatePrinter.TwelveHourField Inner class to output the twelve hour field.
private static class	FastDatePrinter.TwentyFourHourField Inner class to output the twenty four hour field.
private static class	FastDatePrinter.TwoDigitMonthField Inner class to output a two digit month.
private static class	FastDatePrinter.TwoDigitNumberField Inner class to output a two digit number.
private static class	FastDatePrinter.TwoDigitYearField Inner class to output a two digit year.
private static class	FastDatePrinter.UnpaddedMonthField Inner class to output an unpadded month.
private static class	FastDatePrinter.UnpaddedNumberField Inner class to output an unpadded number.
private static class	FastDatePrinter.WeekYear Inner class to output the numeric day in week.

字段概要

字段

限定符和类型	字段和说明
private static ConcurrentMap<FastDatePrinter.TimeZoneDisplayKey,String>	cTimeZoneDisplayCache
private static int	MAX_DIGITS
private int	mMaxLengthEstimate 估算最大长度.
private FastDatePrinter.Rule[]	rules 规则列表.
private static long	serialVersionUID

从类继承的字段 com.github.jarvisframework.tool.core.date.format.AbstractDateBasic

locale, pattern, timeZone

构造器概要

构造器

限定符	构造器和说明
protected	FastDatePrinter(String pattern, TimeZone timeZone, Locale locale) 构造，内部使用

方法概要

限定符和类型	方法和说明
private static void	appendDigits(Appendable buffer, int value) Appends two digits to the given buffer.
private static void	appendFullDigits(Appendable buffer, int value, int minFieldWidth) Appends all digits to the given buffer.
private <B extends Appendable> B	applyRules(Calendar calendar, B buf) Performs the formatting by applying the rules to the specified calendar.
private String	applyRulesToString(Calendar c) Creates a String representation of the given Calendar by applying the rules of this printer to it.
String	format(Calendar calendar) Formats a Calendar object.
<B extends Appendable> B	format(Calendar calendar, B buf) Formats a Calendar object into the supplied Appendable.
String	format(Date date) 使用 GregorianCalendar 格式化 Date
<B extends Appendable> B	format(Date date, B buf) Formats a Date object into the supplied Appendable using a GregorianCalendar.
String	format(long millis) 格式化日期表示的毫秒数
<B extends Appendable> B	format(long millis, B buf) Formats a millisecond long value into the supplied Appendable.
(专用程序包) String	format(Object obj) Formats a Date, Calendar or Long (milliseconds) object.
int	getMaxLengthEstimate() 估算生成的日期字符串长度 实际生成的字符串长度小于或等于此值
(专用程序包) static String	getTimeZoneDisplay(TimeZone tz, boolean daylight, int style, Locale locale) Gets the time zone display name, using a cache for performance.
private void	init() 初始化
protected List<FastDatePrinter.Rule>	parsePattern() Returns a list of Rules given a pattern.
protected String	parseToken(String pattern, int[] indexRef) Performs the parsing of tokens.
private void	readObject(ObjectInputStream in) Create the object after serialization.
protected FastDatePrinter.NumberRule	selectNumberRule(int field, int padding) Gets an appropriate rule for the padding required.

从类继承的方法 com.github.jarvisframework.tool.core.date.format.AbstractDateBasic

equals, getLocale, getPattern, getTimeZone, hashCode, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

从接口继承的方法 com.github.jarvisframework.tool.core.date.format.DateBasic

getLocale, getPattern, getTimeZone

字段详细资料

serialVersionUID

private static final long serialVersionUID

另请参阅:

常量字段值

rules

private transient FastDatePrinter.Rule[] rules

规则列表.

mMaxLengthEstimate

private transient int mMaxLengthEstimate

估算最大长度.

MAX_DIGITS

private static final int MAX_DIGITS

另请参阅:

常量字段值

cTimeZoneDisplayCache

private static final ConcurrentMap<FastDatePrinter.TimeZoneDisplayKey,String> cTimeZoneDisplayCache

构造器详细资料

FastDatePrinter

protected FastDatePrinter(String pattern,
                          TimeZone timeZone,
                          Locale locale)

构造，内部使用

参数:

pattern - 使用SimpleDateFormat 相同的日期格式

timeZone - 非空时区TimeZone

locale - 非空Locale 日期地理位置

方法详细资料

init

private void init()

初始化

parsePattern

protected List<FastDatePrinter.Rule> parsePattern()

Returns a list of Rules given a pattern.

返回:

a List of Rule objects

抛出:

IllegalArgumentException - if pattern is invalid

parseToken

protected String parseToken(String pattern,
                            int[] indexRef)

Performs the parsing of tokens.

参数:

pattern - the pattern

indexRef - index references

返回:

parsed token

selectNumberRule

protected FastDatePrinter.NumberRule selectNumberRule(int field,
                                                      int padding)

Gets an appropriate rule for the padding required.

参数:

field - the field to get a rule for

padding - the padding required

返回:

a new rule with the correct padding

format

String format(Object obj)

Formats a Date, Calendar or Long (milliseconds) object.

参数:

obj - the object to format

返回:

The formatted value.

format

public String format(long millis)

从接口复制的说明: DatePrinter

格式化日期表示的毫秒数

指定者:

format 在接口中 DatePrinter

参数:

millis - 日期毫秒数

返回:

the formatted string

format

public String format(Date date)

从接口复制的说明: DatePrinter

使用 GregorianCalendar 格式化 Date

指定者:

format 在接口中 DatePrinter

参数:

date - 日期 Date

返回:

格式化后的字符串

format

public String format(Calendar calendar)

从接口复制的说明: DatePrinter

Formats a Calendar object.

格式化 Calendar

指定者:

format 在接口中 DatePrinter

参数:

calendar - Calendar

返回:

格式化后的字符串

format

public <B extends Appendable> B format(long millis,
                                       B buf)

从接口复制的说明: DatePrinter

Formats a millisecond long value into the supplied Appendable.

指定者:

format 在接口中 DatePrinter

类型参数:

B - the Appendable class type, usually StringBuilder or StringBuffer.

参数:

millis - the millisecond value to format

buf - the buffer to format into

返回:

the specified string buffer

format

public <B extends Appendable> B format(Date date,
                                       B buf)

从接口复制的说明: DatePrinter

Formats a Date object into the supplied Appendable using a GregorianCalendar.

指定者:

format 在接口中 DatePrinter

类型参数:

B - the Appendable class type, usually StringBuilder or StringBuffer.

参数:

date - the date to format

buf - the buffer to format into

返回:

the specified string buffer

format

public <B extends Appendable> B format(Calendar calendar,
                                       B buf)

从接口复制的说明: DatePrinter

Formats a Calendar object into the supplied Appendable.

The TimeZone set on the Calendar is only used to adjust the time offset. The TimeZone specified during the construction of the Parser will determine the TimeZone used in the formatted string.

指定者:

format 在接口中 DatePrinter

类型参数:

B - the Appendable class type, usually StringBuilder or StringBuffer.

参数:

calendar - the calendar to format

buf - the buffer to format into

返回:

the specified string buffer

applyRulesToString

private String applyRulesToString(Calendar c)

Creates a String representation of the given Calendar by applying the rules of this printer to it.

参数:

c - the Calender to apply the rules to.

返回:

a String representation of the given Calendar.

applyRules

private <B extends Appendable> B applyRules(Calendar calendar,
                                            B buf)

Performs the formatting by applying the rules to the specified calendar.

类型参数:

B - the Appendable class type, usually StringBuilder or StringBuffer.

参数:

calendar - the calendar to format

buf - the buffer to format into

返回:

the specified string buffer

getMaxLengthEstimate

public int getMaxLengthEstimate()

估算生成的日期字符串长度
实际生成的字符串长度小于或等于此值

返回:

日期字符串长度

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
                        ClassNotFoundException

Create the object after serialization. This implementation reinitializes the transient properties.

参数:

in - ObjectInputStream from which the object is being deserialized.

抛出:

IOException - if there is an IO issue.

ClassNotFoundException - if a class cannot be found.

appendDigits

private static void appendDigits(Appendable buffer,
                                 int value)
                          throws IOException

Appends two digits to the given buffer.

参数:

buffer - the buffer to append to.

value - the value to append digits from.

抛出:

IOException

appendFullDigits

private static void appendFullDigits(Appendable buffer,
                                     int value,
                                     int minFieldWidth)
                              throws IOException

Appends all digits to the given buffer.

参数:

buffer - the buffer to append to.

value - the value to append digits from.

抛出:

IOException

getTimeZoneDisplay

static String getTimeZoneDisplay(TimeZone tz,
                                 boolean daylight,
                                 int style,
                                 Locale locale)

Gets the time zone display name, using a cache for performance.

参数:

tz - the zone to query

daylight - true if daylight savings

style - the style to use TimeZone.LONG or TimeZone.SHORT

locale - the locale to use

返回:

the textual name of the time zone