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

类 FastDateParser

java.lang.Object

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

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

所有已实现的接口:

DateBasic, DateParser, Serializable

class FastDateParser
extends AbstractDateBasic
implements DateParser

SimpleDateFormat 的线程安全版本，用于解析日期字符串并转换为 Date 对象
Thanks to Apache Commons Lang 3.5

从以下版本开始:

1.0, 2020-07-24 15:59:30

作者:

Doug Wang

嵌套类概要

嵌套类

限定符和类型	类和说明
private static class	FastDateParser.CaseInsensitiveTextStrategy A strategy that handles a text field in the parsing pattern
private static class	FastDateParser.CopyQuotedStrategy A strategy that copies the static or quoted field in the parsing pattern
private static class	FastDateParser.ISO8601TimeZoneStrategy
private static class	FastDateParser.NumberStrategy A strategy that handles a number field in the parsing pattern
private static class	FastDateParser.PatternStrategy A strategy to parse a single field from the parsing pattern
private static class	FastDateParser.Strategy 单个日期字段的分析策略
private static class	FastDateParser.StrategyAndWidth Holds strategy and field width
private class	FastDateParser.StrategyParser Parse format into Strategies
(专用程序包) static class	FastDateParser.TimeZoneStrategy A strategy that handles a timezone field in the parsing pattern

字段概要

字段

限定符和类型	字段和说明
private static FastDateParser.Strategy	ABBREVIATED_YEAR_STRATEGY
private static ConcurrentMap<Locale,FastDateParser.Strategy>[]	caches
private int	century 世纪：2000年前为19， 之后为20
private static FastDateParser.Strategy	DAY_OF_MONTH_STRATEGY
private static FastDateParser.Strategy	DAY_OF_WEEK_IN_MONTH_STRATEGY
private static FastDateParser.Strategy	DAY_OF_WEEK_STRATEGY
private static FastDateParser.Strategy	DAY_OF_YEAR_STRATEGY
private static FastDateParser.Strategy	HOUR_OF_DAY_STRATEGY
private static FastDateParser.Strategy	HOUR_STRATEGY
private static FastDateParser.Strategy	HOUR12_STRATEGY
private static FastDateParser.Strategy	HOUR24_OF_DAY_STRATEGY
(专用程序包) static Locale	JAPANESE_IMPERIAL
private static FastDateParser.Strategy	LITERAL_YEAR_STRATEGY
private static Comparator<String>	LONGER_FIRST_LOWERCASE
private static FastDateParser.Strategy	MILLISECOND_STRATEGY
private static FastDateParser.Strategy	MINUTE_STRATEGY
private static FastDateParser.Strategy	NUMBER_MONTH_STRATEGY
private List<FastDateParser.StrategyAndWidth>	patterns
private static FastDateParser.Strategy	SECOND_STRATEGY
private static long	serialVersionUID
private int	startYear
private static FastDateParser.Strategy	WEEK_OF_MONTH_STRATEGY
private static FastDateParser.Strategy	WEEK_OF_YEAR_STRATEGY

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

locale, pattern, timeZone

构造器概要

构造器

限定符	构造器和说明
protected	FastDateParser(String pattern, TimeZone timeZone, Locale locale) Constructs a new FastDateParser.
protected	FastDateParser(String pattern, TimeZone timeZone, Locale locale, Date centuryStart) Constructs a new FastDateParser.

方法概要

限定符和类型	方法和说明
private int	adjustYear(int twoDigitYear) 使用当前的世纪调整两位数年份为四位数年份
private static Map<String,Integer>	appendDisplayNames(Calendar cal, Locale locale, int field, StringBuilder regex) Get the short and long values displayed for a field
private static ConcurrentMap<Locale,FastDateParser.Strategy>	getCache(int field) Get a cache of Strategies for a particular field
private FastDateParser.Strategy	getLocaleSpecificStrategy(int field, Calendar definingCalendar) Construct a Strategy that parses a Text field
private FastDateParser.Strategy	getStrategy(char f, int width, Calendar definingCalendar) Obtain a Strategy given a field from a SimpleDateFormat pattern
private void	init(Calendar definingCalendar) Initialize derived fields from defining fields.
private static boolean	isFormatLetter(char c)
Date	parse(String source) 将日期字符串解析并转换为 Date 对象 等价于 DateFormat.parse(String)
Date	parse(String source, ParsePosition pos) 将日期字符串解析并转换为 Date 对象 等价于 DateFormat.parse(String, ParsePosition)
boolean	parse(String source, ParsePosition pos, Calendar calendar) 根据给定格式转换日期字符串 Updates the Calendar with parsed fields.
Object	parseObject(String source) 将日期字符串解析并转换为 Date 对象
Object	parseObject(String source, ParsePosition pos) 根据 ParsePosition 给定将日期字符串解析并转换为 Date 对象
private void	readObject(ObjectInputStream in) Create the object after serialization.
private static StringBuilder	simpleQuote(StringBuilder sb, String value)

从类继承的方法 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

另请参阅:

常量字段值

JAPANESE_IMPERIAL

static final Locale JAPANESE_IMPERIAL

century

private final int century

世纪：2000年前为19， 之后为20

startYear

private final int startYear

patterns

private transient List<FastDateParser.StrategyAndWidth> patterns

LONGER_FIRST_LOWERCASE

private static final Comparator<String> LONGER_FIRST_LOWERCASE

caches

private static final ConcurrentMap<Locale,FastDateParser.Strategy>[] caches

ABBREVIATED_YEAR_STRATEGY

private static final FastDateParser.Strategy ABBREVIATED_YEAR_STRATEGY

NUMBER_MONTH_STRATEGY

private static final FastDateParser.Strategy NUMBER_MONTH_STRATEGY

LITERAL_YEAR_STRATEGY

private static final FastDateParser.Strategy LITERAL_YEAR_STRATEGY

WEEK_OF_YEAR_STRATEGY

private static final FastDateParser.Strategy WEEK_OF_YEAR_STRATEGY

WEEK_OF_MONTH_STRATEGY

private static final FastDateParser.Strategy WEEK_OF_MONTH_STRATEGY

DAY_OF_YEAR_STRATEGY

private static final FastDateParser.Strategy DAY_OF_YEAR_STRATEGY

DAY_OF_MONTH_STRATEGY

private static final FastDateParser.Strategy DAY_OF_MONTH_STRATEGY

DAY_OF_WEEK_STRATEGY

private static final FastDateParser.Strategy DAY_OF_WEEK_STRATEGY

DAY_OF_WEEK_IN_MONTH_STRATEGY

private static final FastDateParser.Strategy DAY_OF_WEEK_IN_MONTH_STRATEGY

HOUR_OF_DAY_STRATEGY

private static final FastDateParser.Strategy HOUR_OF_DAY_STRATEGY

HOUR24_OF_DAY_STRATEGY

private static final FastDateParser.Strategy HOUR24_OF_DAY_STRATEGY

HOUR12_STRATEGY

private static final FastDateParser.Strategy HOUR12_STRATEGY

HOUR_STRATEGY

private static final FastDateParser.Strategy HOUR_STRATEGY

MINUTE_STRATEGY

private static final FastDateParser.Strategy MINUTE_STRATEGY

SECOND_STRATEGY

private static final FastDateParser.Strategy SECOND_STRATEGY

MILLISECOND_STRATEGY

private static final FastDateParser.Strategy MILLISECOND_STRATEGY

构造器详细资料

FastDateParser

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

Constructs a new FastDateParser.

Use FastDateFormat.getInstance(String, TimeZone, Locale) or another variation of the factory methods of FastDateFormat to get a cached FastDateParser instance.

参数:

pattern - non-null SimpleDateFormat compatible pattern

timeZone - non-null time zone to use

locale - non-null locale

FastDateParser

protected FastDateParser(String pattern,
                         TimeZone timeZone,
                         Locale locale,
                         Date centuryStart)

Constructs a new FastDateParser.

参数:

pattern - non-null SimpleDateFormat compatible pattern

timeZone - non-null time zone to use

locale - non-null locale

centuryStart - The start of the century for 2 digit year parsing

方法详细资料

init

private void init(Calendar definingCalendar)

Initialize derived fields from defining fields. This is called from constructor and from readObject (de-serialization)

参数:

definingCalendar - the Calendar instance used to initialize this FastDateParser

isFormatLetter

private static boolean isFormatLetter(char c)

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.

parseObject

public Object parseObject(String source)
                   throws ParseException

从接口复制的说明: DateParser

将日期字符串解析并转换为 Date 对象

指定者:

parseObject 在接口中 DateParser

参数:

source - A String whose beginning should be parsed.

返回:

a java.util.Date object

抛出:

ParseException - if the beginning of the specified string cannot be parsed.

另请参阅:

Format.parseObject(String)

parse

public Date parse(String source)
           throws ParseException

从接口复制的说明: DateParser

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

指定者:

parse 在接口中 DateParser

参数:

source - 日期字符串

返回:

Date

抛出:

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

parseObject

public Object parseObject(String source,
                          ParsePosition pos)

从接口复制的说明: DateParser

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

指定者:

parseObject 在接口中 DateParser

参数:

source - A String whose beginning should be parsed.

pos - the parse position

返回:

a java.util.Date object

另请参阅:

DateFormat.parseObject(String, ParsePosition)

parse

public Date parse(String source,
                  ParsePosition pos)

从接口复制的说明: DateParser

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

指定者:

parse 在接口中 DateParser

参数:

source - 日期字符串

pos - ParsePosition

返回:

Date

parse

public boolean parse(String source,
                     ParsePosition pos,
                     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)

simpleQuote

private static StringBuilder simpleQuote(StringBuilder sb,
                                         String value)

appendDisplayNames

private static Map<String,Integer> appendDisplayNames(Calendar cal,
                                                      Locale locale,
                                                      int field,
                                                      StringBuilder regex)

Get the short and long values displayed for a field

参数:

cal - The calendar to obtain the short and long values

locale - The locale of display names

field - The field of interest

regex - The regular expression to build

返回:

The map of string display names to field values

adjustYear

private int adjustYear(int twoDigitYear)

使用当前的世纪调整两位数年份为四位数年份

参数:

twoDigitYear - 两位数年份

返回:

A value between centuryStart(inclusive) to centuryStart+100(exclusive)

getStrategy

private FastDateParser.Strategy getStrategy(char f,
                                            int width,
                                            Calendar definingCalendar)

Obtain a Strategy given a field from a SimpleDateFormat pattern

参数:

f - 格式

width - 长度

definingCalendar - The calendar to obtain the short and long values

返回:

The Strategy that will handle parsing for the field

getCache

private static ConcurrentMap<Locale,FastDateParser.Strategy> getCache(int field)

Get a cache of Strategies for a particular field

参数:

field - The Calendar field

返回:

a cache of Locale to Strategy

getLocaleSpecificStrategy

private FastDateParser.Strategy getLocaleSpecificStrategy(int field,
                                                          Calendar definingCalendar)

Construct a Strategy that parses a Text field

参数:

field - The Calendar field

definingCalendar - The calendar to obtain the short and long values

返回:

a TextStrategy for the field and Locale