Package org.miaixz.bus.core.center.date.format.parser

Class FastDateParser

java.lang.Object

org.miaixz.bus.core.center.date.printer.SimpleDatePrinter

org.miaixz.bus.core.center.date.format.parser.FastDateParser

All Implemented Interfaces:

Serializable, DateParser, PositionDateParser, DatePrinter

public class FastDateParser
extends SimpleDatePrinter
implements PositionDateParser

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

Since:

Java 17+

Author:

Kimi Liu

See Also:

• FastDatePrinter
• Serialized Form

Field Summary

Fields inherited from class org.miaixz.bus.core.center.date.printer.SimpleDatePrinter

locale, pattern, timeZone

Constructor Summary

Constructors

Constructor	Description
FastDateParser(String pattern, TimeZone timeZone, Locale locale)	Constructs a new FastDateParser.
FastDateParser(String pattern, TimeZone timeZone, Locale locale, Date centuryStart)	Constructs a new FastDateParser.

Method Summary

Modifier and Type	Method	Description
Date	parse(CharSequence source)	将日期字符串解析并转换为 Date 对象
Date	parse(CharSequence source, ParsePosition pos)	将日期字符串解析并转换为 Date 对象 等价于 DateFormat.parse(String, ParsePosition)
boolean	parse(CharSequence source, ParsePosition pos, Calendar calendar)	根据给定格式更新Calendar 解析成功后，ParsePosition.getIndex()更新成转换到的位置 失败则ParsePosition.getErrorIndex()更新到解析失败的位置

Methods inherited from class org.miaixz.bus.core.center.date.printer.SimpleDatePrinter

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 org.miaixz.bus.core.center.date.printer.DatePrinter

getLocale, getPattern, getTimeZone

Constructor Details

FastDateParser

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

Constructs a new FastDateParser.

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

Parameters:

pattern - non-null SimpleDateFormat compatible pattern

timeZone - non-null time zone to use

locale - non-null locale

FastDateParser

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

Constructs a new FastDateParser.

Parameters:

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

Method Details

parse

public Date parse(CharSequence source)
           throws DateException

Description copied from interface: DateParser

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

Specified by:

parse in interface DateParser

Parameters:

source - 被解析的日期字符串

Returns:

Date对象

Throws:

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

parse

public Date parse(CharSequence source,
 ParsePosition pos)

Description copied from interface: PositionDateParser

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

Specified by:

parse in interface PositionDateParser

Parameters:

source - 日期字符串

pos - ParsePosition

Returns:

Date

parse

public boolean parse(CharSequence source,
 ParsePosition pos,
 Calendar calendar)

Description copied from interface: PositionDateParser

根据给定格式更新Calendar 解析成功后，ParsePosition.getIndex()更新成转换到的位置 失败则ParsePosition.getErrorIndex()更新到解析失败的位置

Specified by:

parse in interface PositionDateParser

Parameters:

source - 被转换的日期字符串

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

calendar - 解析并更新的Calendar

Returns:

解析成功返回 true，否则返回false