java.text.spi
类 DateFormatProvider

java.lang.Object
  java.util.spi.LocaleServiceProvider
      java.text.spi.DateFormatProvider

public abstract class DateFormatProvider
extends LocaleServiceProvider

提供 DateFormat 类具体实现的服务提供者的抽象类。

从以下版本开始：

1.6

构造方法摘要

protected

DateFormatProvider() 唯一的构造方法。

方法摘要

abstract DateFormat	getDateInstance(int style, Locale locale) 返回新的 DateFormat 实例，此实例使用指定语言环境的给定格式化风格来格式化日期。
abstract DateFormat	getDateTimeInstance(int dateStyle, int timeStyle, Locale locale) 返回新的 DateFormat 实例，此实例使用指定语言环境的给定格式化风格来格式化日期和时间。
abstract DateFormat	getTimeInstance(int style, Locale locale) 返回一个新的 DateFormat 实例，此实例使用指定语言环境的给定格式化风格来格式化时间。

从类 java.util.spi.LocaleServiceProvider 继承的方法

getAvailableLocales

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

DateFormatProvider

protected DateFormatProvider()

唯一的构造方法。（由子类构造方法调用，通常是隐式的）。

方法详细信息

getTimeInstance

public abstract DateFormat getTimeInstance(int style,
                                           Locale locale)

返回一个新的 DateFormat 实例，此实例使用指定语言环境的给定格式化风格来格式化时间。

参数：

style - 给定的格式化风格。DateFormat.SHORT、DateFormat.MEDIUM、DateFormat.LONG 或 DateFormat.FULL 之一。

locale - 所需的语言环境。

返回：

一个时间格式器

抛出：

IllegalArgumentException - 如果 style 无效，或者 locale 不是 getAvailableLocales() 返回的语言环境之一。

NullPointerException - 如果 locale 为 null

另请参见：

DateFormat.getTimeInstance(int, java.util.Locale)

getDateInstance

public abstract DateFormat getDateInstance(int style,
                                           Locale locale)

返回新的 DateFormat 实例，此实例使用指定语言环境的给定格式化风格来格式化日期。

参数：

style - 给定的格式化风格。DateFormat.SHORT、DateFormat.MEDIUM、DateFormat.LONG 或 DateFormat.FULL 之一。

locale - 所需的语言环境。

返回：

一个日期格式器

抛出：

IllegalArgumentException - 如果 style 无效，或者 locale 不是 getAvailableLocales() 返回的语言环境之一。

NullPointerException - 如果 locale 为 null

另请参见：

DateFormat.getDateInstance(int, java.util.Locale)

getDateTimeInstance

public abstract DateFormat getDateTimeInstance(int dateStyle,
                                               int timeStyle,
                                               Locale locale)

返回新的 DateFormat 实例，此实例使用指定语言环境的给定格式化风格来格式化日期和时间。

参数：

dateStyle - 给定的日期格式化风格。DateFormat.SHORT、DateFormat.MEDIUM、DateFormat.LONG 或 DateFormat.FULL 之一。

timeStyle - 给定的时间格式化风格。DateFormat.SHORT、DateFormat.MEDIUM、DateFormat.LONG 或 DateFormat.FULL 之一。

locale - 所需的语言环境。

返回：

一个 日期/时间格式器。

抛出：

IllegalArgumentException - 如果 dateStyle 或 timeStyle 无效，如果 locale 不是 getAvailableLocales() 返回的语言环境之一。

NullPointerException - 如果 locale 为 null

另请参见：

DateFormat.getDateTimeInstance(int, int, java.util.Locale)