cn.hutool.core.date.format

Class FastDatePrinter

java.lang.Object

cn.hutool.core.date.format.AbstractDateBasic

cn.hutool.core.date.format.FastDatePrinter

All Implemented Interfaces:

DateBasic, DatePrinter, Serializable

public class FastDatePrinter
extends AbstractDateBasic
implements DatePrinter

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

See Also:

FastDateParser, Serialized Form

Field Summary

Fields inherited from class cn.hutool.core.date.format.AbstractDateBasic

locale, pattern, timeZone

Constructor Summary

Constructors

Constructor and Description
FastDatePrinter(String pattern, TimeZone timeZone, Locale locale) 构造，内部使用

Method Summary

Modifier and Type	Method and Description
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.
int	getMaxLengthEstimate() 估算生成的日期字符串长度 实际生成的字符串长度小于或等于此值
protected List<cn.hutool.core.date.format.FastDatePrinter.Rule>	parsePattern() Returns a list of Rules given a pattern.
protected String	parseToken(String pattern, int[] indexRef) Performs the parsing of tokens.
protected cn.hutool.core.date.format.FastDatePrinter.NumberRule	selectNumberRule(int field, int padding) Gets an appropriate rule for the padding required.

Methods inherited from class cn.hutool.core.date.format.AbstractDateBasic

equals, getLocale, getPattern, getTimeZone, hashCode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface cn.hutool.core.date.format.DateBasic

getLocale, getPattern, getTimeZone

Constructor Detail

FastDatePrinter

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

构造，内部使用

Parameters:

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

timeZone - 非空时区TimeZone

locale - 非空Locale 日期地理位置

Method Detail

parsePattern

protected List<cn.hutool.core.date.format.FastDatePrinter.Rule> parsePattern()

Returns a list of Rules given a pattern.

Returns:

a List of Rule objects

Throws:

IllegalArgumentException - if pattern is invalid

parseToken

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

Performs the parsing of tokens.

Parameters:

pattern - the pattern

indexRef - index references

Returns:

parsed token

selectNumberRule

protected cn.hutool.core.date.format.FastDatePrinter.NumberRule selectNumberRule(int field,
                                                                                 int padding)

Gets an appropriate rule for the padding required.

Parameters:

field - the field to get a rule for

padding - the padding required

Returns:

a new rule with the correct padding

format

public String format(long millis)

Description copied from interface: DatePrinter

格式化日期表示的毫秒数

Specified by:

format in interface DatePrinter

Parameters:

millis - 日期毫秒数

Returns:

the formatted string

format

public String format(Date date)

Description copied from interface: DatePrinter

使用 GregorianCalendar 格式化 Date

Specified by:

format in interface DatePrinter

Parameters:

date - 日期 Date

Returns:

格式化后的字符串

format

public String format(Calendar calendar)

Description copied from interface: DatePrinter

Formats a Calendar object.

格式化 Calendar

Specified by:

format in interface DatePrinter

Parameters:

calendar - Calendar

Returns:

格式化后的字符串

format

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

Description copied from interface: DatePrinter

Formats a millisecond long value into the supplied Appendable.

Specified by:

format in interface DatePrinter

Type Parameters:

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

Parameters:

millis - the millisecond value to format

buf - the buffer to format into

Returns:

the specified string buffer

format

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

Description copied from interface: DatePrinter

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

Specified by:

format in interface DatePrinter

Type Parameters:

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

Parameters:

date - the date to format

buf - the buffer to format into

Returns:

the specified string buffer

format

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

Description copied from interface: 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.

Specified by:

format in interface DatePrinter

Type Parameters:

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

Parameters:

calendar - the calendar to format

buf - the buffer to format into

Returns:

the specified string buffer

getMaxLengthEstimate

public int getMaxLengthEstimate()

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

Returns:

日期字符串长度