cn.hutool.core.date.format

接口 DateParser

所有超级接口:

DateBasic

所有已知实现类:

FastDateFormat, FastDateParser

public interface DateParser
extends DateBasic

日期解析接口，用于解析日期字符串为 Date 对象
Thanks to Apache Commons Lang 3.5

从以下版本开始:

2.16.2

方法概要

限定符和类型	方法和说明
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) 根据给定格式更新Calendar Upon success, the ParsePosition index is updated to indicate how much of the source text was consumed.
default Object	parseObject(String source) 将日期字符串解析并转换为 Date 对象
default Object	parseObject(String source, ParsePosition pos) 根据 ParsePosition 给定将日期字符串解析并转换为 Date 对象

从接口继承的方法 cn.hutool.core.date.format.DateBasic

getLocale, getPattern, getTimeZone

方法详细资料

parse

Date parse(String source)
    throws ParseException

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

参数:

source - 日期字符串

返回:

Date

抛出:

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

parse

Date parse(String source,
           ParsePosition pos)

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

参数:

source - 日期字符串

pos - ParsePosition

返回:

Date

parse

boolean parse(String source,
              ParsePosition pos,
              Calendar calendar)

根据给定格式更新Calendar 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.

参数:

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)

抛出:

IllegalArgumentException - when Calendar has been set to be not lenient, and a parsed field is out of range.

parseObject

default Object parseObject(String source)
                    throws ParseException

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

参数:

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)

parseObject

default Object parseObject(String source,
                           ParsePosition pos)

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

参数:

source - A String whose beginning should be parsed.

pos - the parse position

返回:

a java.util.Date object

另请参阅:

DateFormat.parseObject(String, ParsePosition)