java.text.spi

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.SHORTDateFormat.MEDIUMDateFormat.LONGDateFormat.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.SHORTDateFormat.MEDIUMDateFormat.LONGDateFormat.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.SHORTDateFormat.MEDIUMDateFormat.LONGDateFormat.FULL 之一。
timeStyle - 给定的时间格式化风格。 DateFormat.SHORTDateFormat.MEDIUMDateFormat.LONGDateFormat.FULL 之一。
locale - 所需的语言环境。
返回:
一个 日期/时间格式器。
抛出:
IllegalArgumentException - 如果 dateStyletimeStyle 无效,如果 locale 不是 getAvailableLocales() 返回的语言环境之一。
NullPointerException - 如果 locale 为 null
另请参见:
DateFormat.getDateTimeInstance(int, int, java.util.Locale)