Module java.base

软件包 java.text.spi

Class DateFormatProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.text.spi.DateFormatProvider

public abstract class DateFormatProvider
extends LocaleServiceProvider

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

从以下版本开始：

1.6

构造方法摘要

构造方法

Modifier	Constructor	描述
protected	DateFormatProvider()	唯一的构造函数。

方法摘要

Modifier and Type	方法	描述
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实例，用于为指定的区域设置格式化给定的格式化样式。

Methods inherited from class java.util.spi.LocaleServiceProvider

getAvailableLocales, isSupportedLocale

Methods inherited from class 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为空

另请参见：

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为空

另请参见：

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为空

另请参见：

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