构造方法详细信息

• SimpleDateFormat

  public SimpleDateFormat()

  构造一个SimpleDateFormat使用默认模式和日期格式符号默认FORMAT区域设置。 注意：此构造函数可能不支持所有语言环境。 要获得完整覆盖，请使用DateFormat类中的工厂方法。

• SimpleDateFormat

  public SimpleDateFormat​(String pattern)

  构造一个SimpleDateFormat使用给定的模式和默认的默认日期格式符号FORMAT区域设置。 注意：此构造函数可能不支持所有语言环境。 要获得完整覆盖，请使用DateFormat类中的工厂方法。

  这相当于致电SimpleDateFormat(pattern, Locale.getDefault(Locale.Category.FORMAT)) 。

  参数

  pattern - 描述日期和时间格式的模式

  异常

  NullPointerException - 如果给定的模式为null

  IllegalArgumentException - 如果给定的模式无效

  另请参见：

  Locale.getDefault(java.util.Locale.Category) ， Locale.Category.FORMAT

• SimpleDateFormat

  public SimpleDateFormat​(String pattern,
                          Locale locale)

  使用给定模式和给定语言环境的默认日期格式符号构造SimpleDateFormat 。 注意：此构造函数可能不支持所有语言环境。 要获得完整覆盖，请使用DateFormat类中的工厂方法。

  参数

  pattern - 描述日期和时间格式的模式

  locale - 应使用其日期格式符号的区域设置

  异常

  NullPointerException - 如果给定的模式或区域设置为null

  IllegalArgumentException - 如果给定的模式无效

• SimpleDateFormat

  public SimpleDateFormat​(String pattern,
                          DateFormatSymbols formatSymbols)

  使用给定的模式和日期格式符号构造 SimpleDateFormat 。

  参数

  pattern - 描述日期和时间格式的模式

  formatSymbols - 要用于格式化的日期格式符号

  异常

  NullPointerException - 如果给定的模式或formatSymbols为null

  IllegalArgumentException - 如果给定的模式无效

方法详细信息

• set2DigitYearStart

  public void set2DigitYearStart​(Date startDate)

  设置100年期间2位数年份将被解释为在用户指定的日期开始。

  参数

  startDate - 在解析期间，两位数年份将放在 startDate到 startDate + 100 years的范围内。

  异常

  NullPointerException - 如果 startDate是 null 。

  从以下版本开始：

  1.2

  另请参见：

  get2DigitYearStart()

• get2DigitYearStart

  public Date get2DigitYearStart()

  返回100年期间的开始日期2位数年份被解释为在其中。

  结果

  解析两位数年份的100年期间的开始

  从以下版本开始：

  1.2

  另请参见：

  set2DigitYearStart(java.util.Date)

• format

  public StringBuffer format​(Date date,
                             StringBuffer toAppendTo,
                             FieldPosition pos)

  将给定的 Date为日期/时间字符串，并将结果附加到给定的 StringBuffer 。

  Specified by:

  format在课程 DateFormat

  参数

  date - 要格式化为日期时间字符串的日期时间值。

  toAppendTo - 要附加新的日期时间文本。

  pos - 跟踪返回字符串中字段的位置。 例如，给定日期时间文本"1996.07.10 AD at 15:08:56 PDT" ，如果给定的fieldPosition是DateFormat.YEAR_FIELD ，则开始索引和结束索引fieldPosition将分别设置为0和4。 请注意，如果相同的日期时间字段在模式中出现多次，则将为该日期时间字段的第一次出现设置fieldPosition 。 例如，对于第一次出现的时区模式字符，使用模式"h a z (zzzz)"和对齐字段DateFormat.TIMEZONE_FIELD将Date格式化为日期时间字符串"1 PM PDT (Pacific Daylight Time)" ，将开始索引和结束索引fieldPosition分别设置为5和8 'z' 。

  结果

  格式化的日期时间字符串。

  异常

  NullPointerException - 如果任何参数是 null 。

• formatToCharacterIterator

  public AttributedCharacterIterator formatToCharacterIterator​(Object obj)

  格式化一个生成AttributedCharacterIterator的对象。 您可以使用返回的AttributedCharacterIterator来构建生成的String，以及确定有关生成的String的信息。

  AttributedCharacterIterator的每个属性键的类型为DateFormat.Field ，其对应的属性值与属性键相同。

  重写：

  formatToCharacterIterator在课程 Format

  参数

  obj - 要格式化的对象

  结果

  AttributedCharacterIterator描述格式化的值。

  异常

  NullPointerException - 如果obj为null。

  IllegalArgumentException - 如果Format无法格式化给定对象，或者Format的模式字符串无效。

  从以下版本开始：

  1.4

• parse

  public Date parse​(String text,
                    ParsePosition pos)

  解析字符串中的文本以生成Date 。

  该方法尝试从pos给出的索引处开始解析文本。 如果解析成功，则在使用最后一个字符之后将索引pos更新为索引（解析不一定使用直到字符串末尾的所有字符），并返回解析的日期。 更新的pos可用于指示下一次调用此方法的起点。 如果发生错误，则不更改索引pos ，将错误索引pos设置为发生错误的字符的索引，并返回null。

  此解析操作使用calendar生成Date 。 在解析之前，所有calendar的日期时间字段都是cleared ，并且calendar的日期时间字段的默认值用于任何缺少的日期时间信息。 例如，如果解析操作没有给出年份值，则解析的Date的年份值为1970， 其中 Date为GregorianCalendar 。 可能会覆盖TimeZone值，具体取决于给定的模式和text的时区值。 之前通过调用setTimeZone设置的任何TimeZone值可能需要恢复以进行进一步操作。

  Specified by:

  parse ，课程 DateFormat

  参数

  text - A String ，其中一部分应该被解析。

  pos - 具有 ParsePosition索引和错误索引信息的 ParsePosition对象。

  结果

  从字符串解析的Date 。 如果出现错误，则返回null。

  异常

  NullPointerException - 如果 text或 pos为空。

• toPattern

  public String toPattern()

  返回描述此日期格式的模式字符串。

  结果

  描述此日期格式的模式字符串。

• toLocalizedPattern

  public String toLocalizedPattern()

  返回描述此日期格式的本地化模式字符串。

  结果

  描述此日期格式的本地化模式字符串。

• applyPattern

  public void applyPattern​(String pattern)

  将给定的模式字符串应用于此日期格式。

  参数

  pattern - 此日期格式的新日期和时间模式

  异常

  NullPointerException - 如果给定的模式为null

  IllegalArgumentException - 如果给定的模式无效

• applyLocalizedPattern

  public void applyLocalizedPattern​(String pattern)

  将给定的本地化模式字符串应用于此日期格式。

  参数

  pattern - 要映射到此格式的新日期和时间格式模式的字符串

  异常

  NullPointerException - 如果给定的模式为null

  IllegalArgumentException - 如果给定的模式无效

• getDateFormatSymbols

  public DateFormatSymbols getDateFormatSymbols()

  获取此日期格式的日期和时间格式符号的副本。

  结果

  此日期格式的日期和时间格式符号

  另请参见：

  setDateFormatSymbols(java.text.DateFormatSymbols)

• setDateFormatSymbols

  public void setDateFormatSymbols​(DateFormatSymbols newFormatSymbols)

  设置此日期格式的日期和时间格式符号。

  参数

  newFormatSymbols - 新的日期和时间格式符号

  异常

  NullPointerException - 如果给定的newFormatSymbols为null

  另请参见：

  getDateFormatSymbols()

• clone

  public Object clone()

  创建此SimpleDateFormat的副本。 这也克隆了格式的日期格式符号。

  重写：

  clone ，课程 DateFormat

  结果

  此 SimpleDateFormat

  另请参见：

  Cloneable

• hashCode

  public int hashCode()

  返回此 SimpleDateFormat对象的哈希码值。

  重写：

  hashCode ，课程 DateFormat

  结果

  此 SimpleDateFormat对象的哈希码值。

  另请参见：

  Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

• equals

  public boolean equals​(Object obj)

  比较给定对象与此 SimpleDateFormat是否相等。

  重写：

  equals在课程 DateFormat

  参数

  obj - 要与之比较的引用对象。

  结果

  如果给定对象等于此 SimpleDateFormat

  另请参见：

  Object.hashCode() ， HashMap