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)