cn.hutool.core.date.format

Interface DateParser

All Superinterfaces:

DateBasic

All Known Implementing Classes:

FastDateFormat, FastDateParser

public interface DateParser
extends DateBasic

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

Since:

2.16.2

Method Summary

Modifier and Type	Method and Description
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 对象

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

getLocale, getPattern, getTimeZone

Method Detail

parse

Date parse(String source)
    throws ParseException

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

Parameters:

source - 日期字符串

Returns:

Date

Throws:

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

parse

Date parse(String source,
           ParsePosition pos)

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

Parameters:

source - 日期字符串

pos - ParsePosition

Returns:

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.

Parameters:

source - 被转换的日期字符串

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

calendar - The calendar into which to set parsed fields.

Returns:

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

Throws:

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 对象

Parameters:

source - A String whose beginning should be parsed.

Returns:

a java.util.Date object

Throws:

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

See Also:

Format.parseObject(String)

parseObject

default Object parseObject(String source,
                           ParsePosition pos)

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

Parameters:

source - A String whose beginning should be parsed.

pos - the parse position

Returns:

a java.util.Date object

See Also:

DateFormat.parseObject(String, ParsePosition)