Interface DateParser

All Superinterfaces:
DateMotd
All Known Implementing Classes:
FastDateParser, FormatBuilder

public interface DateParser extends DateMotd
日期解析接口,用于解析日期字符串为 Date 对象
Since:
Java 17+
Author:
Kimi Liu
  • Method Details

    • 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)
      根据给定格式转换日期字符串 使用解析的字段更新日历。成功之后,将更新ParsePosition索引,以指示消耗了多少源文本。并不是所有的源文本都需要使用 在解析失败时,ParsePosition错误索引将更新为源文本的偏移量,该偏移量与提供的格式不匹配
      Parameters:
      source - 被转换的日期字符串
      pos - 定义开始转换的位置,转换结束后更新转换到的位置
      calendar - 用于设置已解析字段的日历
      Returns:
      如果源已被解析(pos parsePosition 已更新);否则为false(并更新 pos errorIndex)
      Throws:
      IllegalArgumentException - 当日历被设置为不宽松,并且已解析字段超出范围时
    • parseObject

      default Object parseObject(String source) throws ParseException
      将日期字符串解析并转换为 Date 对象
      Parameters:
      source - 应该解析其开头的字符串
      Returns:
      日期对象
      Throws:
      ParseException - 如果无法解析指定字符串的开头
      See Also:
    • parseObject

      default Object parseObject(String source, ParsePosition pos)
      根据 ParsePosition 给定将日期字符串解析并转换为 Date 对象
      Parameters:
      source - 应该解析其开头的字符串
      pos - 解析的位置
      Returns:
      日期对象
      See Also: