jexx.time.format

类 FastDateFormat

java.lang.Object

java.text.Format

jexx.time.format.FastDateFormat

所有已实现的接口:

java.io.Serializable, java.lang.Cloneable, DateBasic, DateParser, DatePrinter

public class FastDateFormat
extends java.text.Format
implements DateParser, DatePrinter

FastDateFormat 是一个线程安全的 SimpleDateFormat 实现。

通过以下静态方法获得此对象:
getInstance(String, TimeZone, Locale)
getDateInstance(int, TimeZone, Locale)
getTimeInstance(int, TimeZone, Locale)
getDateTimeInstance(int, int, TimeZone, Locale)

Thanks to Apache Commons Lang 3.5

从以下版本开始:

2.16.2

另请参阅:

序列化表格

嵌套类概要

从类继承的嵌套类/接口 java.text.Format

java.text.Format.Field

字段概要

字段

限定符和类型	字段和说明
static int	FULL FULL locale dependent date or time style.
static int	LONG LONG locale dependent date or time style.
static int	MEDIUM MEDIUM locale dependent date or time style.
static int	SHORT SHORT locale dependent date or time style.

构造器概要

构造器

限定符	构造器和说明
protected	FastDateFormat(java.lang.String pattern, java.util.TimeZone timeZone, java.util.Locale locale) 构造
protected	FastDateFormat(java.lang.String pattern, java.util.TimeZone timeZone, java.util.Locale locale, java.util.Date centuryStart) 构造

方法概要

限定符和类型	方法和说明
boolean	equals(java.lang.Object obj)
java.lang.String	format(java.util.Calendar calendar) Formats a Calendar object.
<B extends java.lang.Appendable> B	format(java.util.Calendar calendar, B buf) Formats a Calendar object into the supplied Appendable.
java.lang.String	format(java.util.Date date) 使用 GregorianCalendar 格式化 Date
<B extends java.lang.Appendable> B	format(java.util.Date date, B buf) Formats a Date object into the supplied Appendable using a GregorianCalendar.
java.lang.String	format(long millis) 格式化日期表示的毫秒数
<B extends java.lang.Appendable> B	format(long millis, B buf) Formats a millisecond long value into the supplied Appendable.
java.lang.StringBuffer	format(java.lang.Object obj, java.lang.StringBuffer toAppendTo, java.text.FieldPosition pos)
static FastDateFormat	getDateInstance(int style) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getDateInstance(int style, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getDateInstance(int style, java.util.TimeZone timeZone) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getDateInstance(int style, java.util.TimeZone timeZone, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getDateTimeInstance(int dateStyle, int timeStyle) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getDateTimeInstance(int dateStyle, int timeStyle, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getDateTimeInstance(int dateStyle, int timeStyle, java.util.TimeZone timeZone) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getDateTimeInstance(int dateStyle, int timeStyle, java.util.TimeZone timeZone, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getInstance() 获得 FastDateFormat 实例，使用默认格式和地区
static FastDateFormat	getInstance(java.lang.String pattern) 获得 FastDateFormat 实例，使用默认地区 支持缓存
static FastDateFormat	getInstance(java.lang.String pattern, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getInstance(java.lang.String pattern, java.util.TimeZone timeZone) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getInstance(java.lang.String pattern, java.util.TimeZone timeZone, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
java.util.Locale	getLocale() 获得 日期地理位置
int	getMaxLengthEstimate() 估算生成的日期字符串长度 实际生成的字符串长度小于或等于此值
java.lang.String	getPattern() 获得日期格式化或者转换的格式
static FastDateFormat	getTimeInstance(int style) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getTimeInstance(int style, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getTimeInstance(int style, java.util.TimeZone timeZone) 获得 FastDateFormat 实例 支持缓存
static FastDateFormat	getTimeInstance(int style, java.util.TimeZone timeZone, java.util.Locale locale) 获得 FastDateFormat 实例 支持缓存
java.util.TimeZone	getTimeZone() 获得时区
int	hashCode()
java.util.Date	parse(java.lang.String source) 将日期字符串解析并转换为 Date 对象 等价于 DateFormat.parse(String)
java.util.Date	parse(java.lang.String source, java.text.ParsePosition pos) 将日期字符串解析并转换为 Date 对象 等价于 DateFormat.parse(String, ParsePosition)
boolean	parse(java.lang.String source, java.text.ParsePosition pos, java.util.Calendar calendar) 根据给定格式转换日期字符串 Updates the Calendar with parsed fields.
java.lang.Object	parseObject(java.lang.String source, java.text.ParsePosition pos) 根据 ParsePosition 给定将日期字符串解析并转换为 Date 对象
java.lang.String	toString()

从类继承的方法 java.text.Format

clone, format, formatToCharacterIterator, parseObject

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

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

从接口继承的方法 jexx.time.format.DateParser

parseObject

字段详细资料

FULL

public static final int FULL

FULL locale dependent date or time style.

另请参阅:

常量字段值

LONG

public static final int LONG

LONG locale dependent date or time style.

另请参阅:

常量字段值

MEDIUM

public static final int MEDIUM

MEDIUM locale dependent date or time style.

另请参阅:

常量字段值

SHORT

public static final int SHORT

SHORT locale dependent date or time style.

另请参阅:

常量字段值

构造器详细资料

FastDateFormat

protected FastDateFormat(java.lang.String pattern,
                         java.util.TimeZone timeZone,
                         java.util.Locale locale)

构造

参数:

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

timeZone - 非空时区 TimeZone

locale - Locale 日期地理位置

抛出:

java.lang.NullPointerException - if pattern, timeZone, or locale is null.

FastDateFormat

protected FastDateFormat(java.lang.String pattern,
                         java.util.TimeZone timeZone,
                         java.util.Locale locale,
                         java.util.Date centuryStart)

构造

参数:

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

timeZone - 非空时区 TimeZone

locale - Locale 日期地理位置

centuryStart - The start of the 100 year period to use as the "default century" for 2 digit year parsing. If centuryStart is null, defaults to now - 80 years

抛出:

java.lang.NullPointerException - if pattern, timeZone, or locale is null.

方法详细资料

getInstance

public static FastDateFormat getInstance()

获得 FastDateFormat 实例，使用默认格式和地区

返回:

FastDateFormat

getInstance

public static FastDateFormat getInstance(java.lang.String pattern)

获得 FastDateFormat 实例，使用默认地区
支持缓存

参数:

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

返回:

FastDateFormat

抛出:

java.lang.IllegalArgumentException - 日期格式问题

getInstance

public static FastDateFormat getInstance(java.lang.String pattern,
                                         java.util.TimeZone timeZone)

获得 FastDateFormat 实例
支持缓存

参数:

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

timeZone - 时区TimeZone

返回:

FastDateFormat

抛出:

java.lang.IllegalArgumentException - 日期格式问题

getInstance

public static FastDateFormat getInstance(java.lang.String pattern,
                                         java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

locale - Locale 日期地理位置

返回:

FastDateFormat

抛出:

java.lang.IllegalArgumentException - 日期格式问题

getInstance

public static FastDateFormat getInstance(java.lang.String pattern,
                                         java.util.TimeZone timeZone,
                                         java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

timeZone - 时区TimeZone

locale - Locale 日期地理位置

返回:

FastDateFormat

抛出:

java.lang.IllegalArgumentException - 日期格式问题

getDateInstance

public static FastDateFormat getDateInstance(int style)

获得 FastDateFormat 实例
支持缓存

参数:

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

返回:

本地化 FastDateFormat

getDateInstance

public static FastDateFormat getDateInstance(int style,
                                             java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

locale - Locale 日期地理位置

返回:

本地化 FastDateFormat

getDateInstance

public static FastDateFormat getDateInstance(int style,
                                             java.util.TimeZone timeZone)

获得 FastDateFormat 实例
支持缓存

参数:

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

timeZone - 时区TimeZone

返回:

本地化 FastDateFormat

getDateInstance

public static FastDateFormat getDateInstance(int style,
                                             java.util.TimeZone timeZone,
                                             java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

timeZone - 时区TimeZone

locale - Locale 日期地理位置

返回:

本地化 FastDateFormat

getTimeInstance

public static FastDateFormat getTimeInstance(int style)

获得 FastDateFormat 实例
支持缓存

参数:

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

返回:

本地化 FastDateFormat

getTimeInstance

public static FastDateFormat getTimeInstance(int style,
                                             java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

locale - Locale 日期地理位置

返回:

本地化 FastDateFormat

getTimeInstance

public static FastDateFormat getTimeInstance(int style,
                                             java.util.TimeZone timeZone)

获得 FastDateFormat 实例
支持缓存

参数:

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

timeZone - optional time zone, overrides time zone of formatted time

返回:

本地化 FastDateFormat

getTimeInstance

public static FastDateFormat getTimeInstance(int style,
                                             java.util.TimeZone timeZone,
                                             java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

timeZone - optional time zone, overrides time zone of formatted time

locale - Locale 日期地理位置

返回:

本地化 FastDateFormat

getDateTimeInstance

public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle)

获得 FastDateFormat 实例
支持缓存

参数:

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

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

返回:

本地化 FastDateFormat

getDateTimeInstance

public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle,
                                                 java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

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

locale - Locale 日期地理位置

返回:

本地化 FastDateFormat

getDateTimeInstance

public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle,
                                                 java.util.TimeZone timeZone)

获得 FastDateFormat 实例
支持缓存

参数:

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

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

timeZone - 时区TimeZone

返回:

本地化 FastDateFormat

getDateTimeInstance

public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle,
                                                 java.util.TimeZone timeZone,
                                                 java.util.Locale locale)

获得 FastDateFormat 实例
支持缓存

参数:

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

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

timeZone - 时区TimeZone

locale - Locale 日期地理位置

返回:

本地化 FastDateFormat

format

public java.lang.StringBuffer format(java.lang.Object obj,
                                     java.lang.StringBuffer toAppendTo,
                                     java.text.FieldPosition pos)

指定者:

format 在类中 java.text.Format

format

public java.lang.String format(long millis)

从接口复制的说明: DatePrinter

格式化日期表示的毫秒数

指定者:

format 在接口中 DatePrinter

参数:

millis - 日期毫秒数

返回:

the formatted string

format

public java.lang.String format(java.util.Date date)

从接口复制的说明: DatePrinter

使用 GregorianCalendar 格式化 Date

指定者:

format 在接口中 DatePrinter

参数:

date - 日期 Date

返回:

格式化后的字符串

format

public java.lang.String format(java.util.Calendar calendar)

从接口复制的说明: DatePrinter

Formats a Calendar object.

格式化 Calendar

指定者:

format 在接口中 DatePrinter

参数:

calendar - Calendar

返回:

格式化后的字符串

format

public <B extends java.lang.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 java.lang.Appendable> B format(java.util.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 java.lang.Appendable> B format(java.util.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

parse

public java.util.Date parse(java.lang.String source)
                     throws java.text.ParseException

从接口复制的说明: DateParser

将日期字符串解析并转换为 Date 对象
等价于 DateFormat.parse(String)

指定者:

parse 在接口中 DateParser

参数:

source - 日期字符串

返回:

Date

抛出:

java.text.ParseException - 转换异常，被转换的字符串格式错误。

parse

public java.util.Date parse(java.lang.String source,
                            java.text.ParsePosition pos)

从接口复制的说明: DateParser

将日期字符串解析并转换为 Date 对象
等价于 DateFormat.parse(String, ParsePosition)

指定者:

parse 在接口中 DateParser

参数:

source - 日期字符串

pos - ParsePosition

返回:

Date

parse

public boolean parse(java.lang.String source,
                     java.text.ParsePosition pos,
                     java.util.Calendar calendar)

从接口复制的说明: DateParser

根据给定格式转换日期字符串 Updates the Calendar with parsed fields. Upon success, the ParsePosition index is updated to indicate how much of the source text was consumed. Not all source text needs to be consumed. Upon parse failure, ParsePosition error index is updated to the offset of the source text which does not match the supplied format.

指定者:

parse 在接口中 DateParser

参数:

source - 被转换的日期字符串

pos - 定义开始转换的位置，转换结束后更新转换到的位置

calendar - The calendar into which to set parsed fields.

返回:

true, if source has been parsed (pos parsePosition is updated); otherwise false (and pos errorIndex is updated)

parseObject

public java.lang.Object parseObject(java.lang.String source,
                                    java.text.ParsePosition pos)

从接口复制的说明: DateParser

根据 ParsePosition 给定将日期字符串解析并转换为 Date 对象

指定者:

parseObject 在接口中 DateParser

指定者:

parseObject 在类中 java.text.Format

参数:

source - A String whose beginning should be parsed.

pos - the parse position

返回:

a java.util.Date object

另请参阅:

DateFormat.parseObject(String, ParsePosition)

getPattern

public java.lang.String getPattern()

从接口复制的说明: DateBasic

获得日期格式化或者转换的格式

指定者:

getPattern 在接口中 DateBasic

返回:

SimpleDateFormat兼容的格式

getTimeZone

public java.util.TimeZone getTimeZone()

从接口复制的说明: DateBasic

获得时区

指定者:

getTimeZone 在接口中 DateBasic

返回:

TimeZone

getLocale

public java.util.Locale getLocale()

从接口复制的说明: DateBasic

获得 日期地理位置

指定者:

getLocale 在接口中 DateBasic

返回:

Locale

getMaxLengthEstimate

public int getMaxLengthEstimate()

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

返回:

日期字符串长度

equals

public boolean equals(java.lang.Object obj)

覆盖:

equals 在类中 java.lang.Object

hashCode

public int hashCode()

覆盖:

hashCode 在类中 java.lang.Object

toString

public java.lang.String toString()

覆盖:

toString 在类中 java.lang.Object