FastDateFormat (hutool-core 5.8.9 API)

java.lang.Object
- java.text.Format
- - cn.hutool.core.date.format.FastDateFormat

所有已实现的接口:

DateBasic, DateParser, DatePrinter, Serializable, Cloneable
```
public class FastDateFormat
extends Format
implements DateParser, DatePrinter
```
FastDateFormat 是一个线程安全的 SimpleDateFormat 实现。

通过以下静态方法获得此对象:
getInstance(String, TimeZone, Locale)
getDateInstance(int, TimeZone, Locale)
getTimeInstance(int, TimeZone, Locale)
getDateTimeInstance(int, int, TimeZone, Locale)
Thanks to Apache Commons Lang 3.5

从以下版本开始:

2.16.2

另请参阅:

序列化表格

嵌套类概要
- 从类继承的嵌套类/接口 java.text.Format
  Format.Field

字段概要

字段
限定符和类型	字段和说明
`static int`	`FULL` FULL locale dependent date or time style.
`static int`	`LONG` LONG locale dependent date or time style.
`static int`	`MEDIUM` MEDIUM locale dependent date or time style.
`static int`	`SHORT` SHORT locale dependent date or time style.

构造器概要

构造器
限定符	构造器和说明
`protected`	`FastDateFormat(String pattern, TimeZone timeZone, Locale locale)` 构造
`protected`	`FastDateFormat(String pattern, TimeZone timeZone, Locale locale, Date centuryStart)` 构造

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`boolean`	`equals(Object obj)`
`String`	`format(Calendar calendar)` Formats a `Calendar` object.
`<B extends Appendable> B`	`format(Calendar calendar, B buf)` Formats a `Calendar` object into the supplied `Appendable`.
`String`	`format(Date date)` 使用 `GregorianCalendar` 格式化 `Date`
`<B extends Appendable> B`	`format(Date date, B buf)` Formats a `Date` object into the supplied `Appendable` using a `GregorianCalendar`.
`String`	`format(long millis)` 格式化日期表示的毫秒数
`<B extends Appendable> B`	`format(long millis, B buf)` Formats a millisecond `long` value into the supplied `Appendable`.
`StringBuffer`	`format(Object obj, StringBuffer toAppendTo, FieldPosition pos)`
`static FastDateFormat`	`getDateInstance(int style)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getDateInstance(int style, Locale locale)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getDateInstance(int style, TimeZone timeZone)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getDateInstance(int style, TimeZone timeZone, Locale locale)` 获得 FastDateFormat 实例支持缓存
`DateTimeFormatter`	`getDateTimeFormatter()` 便捷获取 DateTimeFormatter 由于 `DatePattern` 很大一部分的格式没有提供 `DateTimeFormatter`,因此这里提供快捷获取方式
`static FastDateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle, Locale locale)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle, TimeZone timeZone)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle, TimeZone timeZone, Locale locale)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getInstance()` 获得 FastDateFormat实例，使用默认格式和地区
`static FastDateFormat`	`getInstance(String pattern)` 获得 FastDateFormat 实例，使用默认地区支持缓存
`static FastDateFormat`	`getInstance(String pattern, Locale locale)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getInstance(String pattern, TimeZone timeZone)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getInstance(String pattern, TimeZone timeZone, Locale locale)` 获得 FastDateFormat 实例支持缓存
`Locale`	`getLocale()` 获得日期地理位置
`int`	`getMaxLengthEstimate()` 估算生成的日期字符串长度实际生成的字符串长度小于或等于此值
`String`	`getPattern()` 获得日期格式化或者转换的格式
`static FastDateFormat`	`getTimeInstance(int style)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getTimeInstance(int style, Locale locale)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getTimeInstance(int style, TimeZone timeZone)` 获得 FastDateFormat 实例支持缓存
`static FastDateFormat`	`getTimeInstance(int style, TimeZone timeZone, Locale locale)` 获得 FastDateFormat 实例支持缓存
`TimeZone`	`getTimeZone()` 获得时区
`int`	`hashCode()`
`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.
`Object`	`parseObject(String source, ParsePosition pos)` 根据 `ParsePosition` 给定将日期字符串解析并转换为 `Date` 对象
`String`	`toString()`

从类继承的方法 java.text.Format
clone, format, formatToCharacterIterator, parseObject

从类继承的方法 java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

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

- 字段详细资料
  - FULL
```
public static final int FULL
```
    FULL locale dependent date or time style.
    
    另请参阅:
    
    常量字段值
  - LONG
```
public static final int LONG
```
    LONG locale dependent date or time style.
    
    另请参阅:
    
    常量字段值
  - MEDIUM
```
public static final int MEDIUM
```
    MEDIUM locale dependent date or time style.
    
    另请参阅:
    
    常量字段值
  - SHORT
```
public static final int SHORT
```
    SHORT locale dependent date or time style.
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - FastDateFormat
```
protected FastDateFormat(String pattern,
                         TimeZone timeZone,
                         Locale locale)
```
    构造
    
    参数:
    
    pattern - 使用SimpleDateFormat 相同的日期格式
    
    timeZone - 非空时区 TimeZone
    
    locale - Locale 日期地理位置
    
    抛出:
    
    NullPointerException - if pattern, timeZone, or locale is null.
  - FastDateFormat
```
protected FastDateFormat(String pattern,
                         TimeZone timeZone,
                         Locale locale,
                         Date centuryStart)
```
    构造
    
    参数:
    
    pattern - 使用SimpleDateFormat 相同的日期格式
    
    timeZone - 非空时区 TimeZone
    
    locale - Locale 日期地理位置
    
    centuryStart - The start of the 100 year period to use as the "default century" for 2 digit year parsing. If centuryStart is null, defaults to now - 80 years
    
    抛出:
    
    NullPointerException - if pattern, timeZone, or locale is null.
- 方法详细资料
  - getInstance
```
public static FastDateFormat getInstance()
```
    获得 FastDateFormat实例，使用默认格式和地区
    
    返回:
    
    FastDateFormat
  - getInstance
```
public static FastDateFormat getInstance(String pattern)
```
    获得 FastDateFormat 实例，使用默认地区
    支持缓存
    
    参数:
    
    pattern - 使用SimpleDateFormat 相同的日期格式
    
    返回:
    
    FastDateFormat
    
    抛出:
    
    IllegalArgumentException - 日期格式问题
  - getInstance
```
public static FastDateFormat getInstance(String pattern,
                                         TimeZone timeZone)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    pattern - 使用SimpleDateFormat 相同的日期格式
    
    timeZone - 时区TimeZone
    
    返回:
    
    FastDateFormat
    
    抛出:
    
    IllegalArgumentException - 日期格式问题
  - getInstance
```
public static FastDateFormat getInstance(String pattern,
                                         Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    pattern - 使用SimpleDateFormat 相同的日期格式
    
    locale - Locale 日期地理位置
    
    返回:
    
    FastDateFormat
    
    抛出:
    
    IllegalArgumentException - 日期格式问题
  - getInstance
```
public static FastDateFormat getInstance(String pattern,
                                         TimeZone timeZone,
                                         Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    pattern - 使用SimpleDateFormat 相同的日期格式
    
    timeZone - 时区TimeZone
    
    locale - Locale 日期地理位置
    
    返回:
    
    FastDateFormat
    
    抛出:
    
    IllegalArgumentException - 日期格式问题
  - getDateInstance
```
public static FastDateFormat getDateInstance(int style)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - date style: FULL, LONG, MEDIUM, or SHORT
    
    返回:
    
    本地化 FastDateFormat
  - getDateInstance
```
public static FastDateFormat getDateInstance(int style,
                                             Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - date style: FULL, LONG, MEDIUM, or SHORT
    
    locale - Locale 日期地理位置
    
    返回:
    
    本地化 FastDateFormat
  - getDateInstance
```
public static FastDateFormat getDateInstance(int style,
                                             TimeZone timeZone)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - date style: FULL, LONG, MEDIUM, or SHORT
    
    timeZone - 时区TimeZone
    
    返回:
    
    本地化 FastDateFormat
  - getDateInstance
```
public static FastDateFormat getDateInstance(int style,
                                             TimeZone timeZone,
                                             Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - date style: FULL, LONG, MEDIUM, or SHORT
    
    timeZone - 时区TimeZone
    
    locale - Locale 日期地理位置
    
    返回:
    
    本地化 FastDateFormat
  - getTimeInstance
```
public static FastDateFormat getTimeInstance(int style)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - time style: FULL, LONG, MEDIUM, or SHORT
    
    返回:
    
    本地化 FastDateFormat
  - getTimeInstance
```
public static FastDateFormat getTimeInstance(int style,
                                             Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - time style: FULL, LONG, MEDIUM, or SHORT
    
    locale - Locale 日期地理位置
    
    返回:
    
    本地化 FastDateFormat
  - getTimeInstance
```
public static FastDateFormat getTimeInstance(int style,
                                             TimeZone timeZone)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - time style: FULL, LONG, MEDIUM, or SHORT
    
    timeZone - optional time zone, overrides time zone of formatted time
    
    返回:
    
    本地化 FastDateFormat
  - getTimeInstance
```
public static FastDateFormat getTimeInstance(int style,
                                             TimeZone timeZone,
                                             Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    style - time style: FULL, LONG, MEDIUM, or SHORT
    
    timeZone - optional time zone, overrides time zone of formatted time
    
    locale - Locale 日期地理位置
    
    返回:
    
    本地化 FastDateFormat
  - getDateTimeInstance
```
public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    dateStyle - date style: FULL, LONG, MEDIUM, or SHORT
    
    timeStyle - time style: FULL, LONG, MEDIUM, or SHORT
    
    返回:
    
    本地化 FastDateFormat
  - getDateTimeInstance
```
public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle,
                                                 Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    dateStyle - date style: FULL, LONG, MEDIUM, or SHORT
    
    timeStyle - time style: FULL, LONG, MEDIUM, or SHORT
    
    locale - Locale 日期地理位置
    
    返回:
    
    本地化 FastDateFormat
  - getDateTimeInstance
```
public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle,
                                                 TimeZone timeZone)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    dateStyle - date style: FULL, LONG, MEDIUM, or SHORT
    
    timeStyle - time style: FULL, LONG, MEDIUM, or SHORT
    
    timeZone - 时区TimeZone
    
    返回:
    
    本地化 FastDateFormat
  - getDateTimeInstance
```
public static FastDateFormat getDateTimeInstance(int dateStyle,
                                                 int timeStyle,
                                                 TimeZone timeZone,
                                                 Locale locale)
```
    获得 FastDateFormat 实例
    支持缓存
    
    参数:
    
    dateStyle - date style: FULL, LONG, MEDIUM, or SHORT
    
    timeStyle - time style: FULL, LONG, MEDIUM, or SHORT
    
    timeZone - 时区TimeZone
    
    locale - Locale 日期地理位置
    
    返回:
    
    本地化 FastDateFormat
  - format
```
public StringBuffer format(Object obj,
                           StringBuffer toAppendTo,
                           FieldPosition pos)
```
    指定者:
    
    format 在类中 Format
  - format
```
public String format(long millis)
```
    从接口复制的说明: DatePrinter
    
    格式化日期表示的毫秒数
    
    指定者:
    
    format 在接口中 DatePrinter
    
    参数:
    
    millis - 日期毫秒数
    
    返回:
    
    the formatted string
  - format
```
public String format(Date date)
```
    从接口复制的说明: DatePrinter
    
    使用 GregorianCalendar 格式化 Date
    
    指定者:
    
    format 在接口中 DatePrinter
    
    参数:
    
    date - 日期 Date
    
    返回:
    
    格式化后的字符串
  - format
```
public String format(Calendar calendar)
```
    从接口复制的说明: DatePrinter
    
    Formats a Calendar object.
    格式化 Calendar
    
    指定者:
    
    format 在接口中 DatePrinter
    
    参数:
    
    calendar - Calendar
    
    返回:
    
    格式化后的字符串
  - format
```
public <B extends Appendable> B format(long millis,
                                       B buf)
```
    从接口复制的说明: DatePrinter
    
    Formats a millisecond long value into the supplied Appendable.
    
    指定者:
    
    format 在接口中 DatePrinter
    
    类型参数:
    
    B - the Appendable class type, usually StringBuilder or StringBuffer.
    
    参数:
    
    millis - the millisecond value to format
    
    buf - the buffer to format into
    
    返回:
    
    the specified string buffer
  - format
```
public <B extends Appendable> B format(Date date,
                                       B buf)
```
    从接口复制的说明: DatePrinter
    
    Formats a Date object into the supplied Appendable using a GregorianCalendar.
    
    指定者:
    
    format 在接口中 DatePrinter
    
    类型参数:
    
    B - the Appendable class type, usually StringBuilder or StringBuffer.
    
    参数:
    
    date - the date to format
    
    buf - the buffer to format into
    
    返回:
    
    the specified string buffer
  - format
```
public <B extends Appendable> B format(Calendar calendar,
                                       B buf)
```
    从接口复制的说明: DatePrinter
    
    Formats a Calendar object into the supplied Appendable.
    The TimeZone set on the Calendar is only used to adjust the time offset. The TimeZone specified during the construction of the Parser will determine the TimeZone used in the formatted string.
    
    指定者:
    
    format 在接口中 DatePrinter
    
    类型参数:
    
    B - the Appendable class type, usually StringBuilder or StringBuffer.
    
    参数:
    
    calendar - the calendar to format
    
    buf - the buffer to format into
    
    返回:
    
    the specified string buffer
  - parse
```
public Date parse(String source)
           throws ParseException
```
    从接口复制的说明: DateParser
    
    将日期字符串解析并转换为 Date 对象
    等价于 DateFormat.parse(String)
    
    指定者:
    
    parse 在接口中 DateParser
    
    参数:
    
    source - 日期字符串
    
    返回:
    
    Date
    
    抛出:
    
    ParseException - 转换异常，被转换的字符串格式错误。
  - 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
    
    根据给定格式更新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.
    
    指定者:
    
    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)
  - parseObject
```
public Object parseObject(String source,
                          ParsePosition pos)
```
    从接口复制的说明: DateParser
    
    根据 ParsePosition 给定将日期字符串解析并转换为 Date 对象
    
    指定者:
    
    parseObject 在接口中 DateParser
    
    指定者:
    
    parseObject 在类中 Format
    
    参数:
    
    source - A String whose beginning should be parsed.
    
    pos - the parse position
    
    返回:
    
    a java.util.Date object
    
    另请参阅:
    
    DateFormat.parseObject(String, ParsePosition)
  - getPattern
```
public String getPattern()
```
    从接口复制的说明: DateBasic
    
    获得日期格式化或者转换的格式
    
    指定者:
    
    getPattern 在接口中 DateBasic
    
    返回:
    
    SimpleDateFormat兼容的格式
  - getTimeZone
```
public TimeZone getTimeZone()
```
    从接口复制的说明: DateBasic
    
    获得时区
    
    指定者:
    
    getTimeZone 在接口中 DateBasic
    
    返回:
    
    TimeZone
  - getLocale
```
public Locale getLocale()
```
    从接口复制的说明: DateBasic
    
    获得日期地理位置
    
    指定者:
    
    getLocale 在接口中 DateBasic
    
    返回:
    
    Locale
  - getMaxLengthEstimate
```
public int getMaxLengthEstimate()
```
    估算生成的日期字符串长度
    实际生成的字符串长度小于或等于此值
    
    返回:
    
    日期字符串长度
  - getDateTimeFormatter
```
public DateTimeFormatter getDateTimeFormatter()
```
    便捷获取 DateTimeFormatter 由于 DatePattern 很大一部分的格式没有提供 DateTimeFormatter,因此这里提供快捷获取方式
    
    返回:
    
    DateTimeFormatter
    
    从以下版本开始:
    
    5.6.4
  - equals
```
public boolean equals(Object obj)
```
    覆盖:
    
    equals 在类中 Object
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类中 Object
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 FastDateFormat

嵌套类概要

从类继承的嵌套类/接口 java.text.Format

字段概要

构造器概要

方法概要

从类继承的方法 java.text.Format

从类继承的方法 java.lang.Object

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

字段详细资料

FULL

LONG

MEDIUM

SHORT

构造器详细资料

FastDateFormat

FastDateFormat

方法详细资料

getInstance

getInstance

getInstance

getInstance

getInstance

getDateInstance

getDateInstance

getDateInstance

getDateInstance

getTimeInstance

getTimeInstance

getTimeInstance

getTimeInstance

getDateTimeInstance

getDateTimeInstance

getDateTimeInstance

getDateTimeInstance

format

format

format

format

format

format

format

parse

parse

parse

parseObject

getPattern

getTimeZone

getLocale

getMaxLengthEstimate

getDateTimeFormatter

equals

hashCode

toString