java.text.spi
Class DateFormatProvider

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

public abstract class DateFormatProvider
extends LocaleServiceProvider

A DateFormatProvider provides localized instances of DateFormat.

Since:
1.6

Constructor Summary
protected DateFormatProvider()
          Constructs a new DateFormatProvider.
 
Method Summary
abstract  DateFormat getDateInstance(int style, Locale locale)
          Returns a DateFormat instance for formatting dates with the given style in the specified Locale.
abstract  DateFormat getDateTimeInstance(int dateStyle, int timeStyle, Locale locale)
          Returns a DateFormat instance for formatting dates and times with the given style in the specified Locale.
abstract  DateFormat getTimeInstance(int style, Locale locale)
          Returns a DateFormat instance for formatting times with the given style in the specified Locale.
 
Methods inherited from class java.util.spi.LocaleServiceProvider
getAvailableLocales
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DateFormatProvider

protected DateFormatProvider()
Constructs a new DateFormatProvider. Provided for implicit invocation by subclasses.

Method Detail

getDateInstance

public abstract DateFormat getDateInstance(int style,
                                           Locale locale)
Returns a DateFormat instance for formatting dates with the given style in the specified Locale.

Parameters:
style - the formatting style; one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG or DateFormat.FULL.
locale - the desired locale.
Returns:
the localized instance for formatting dates.
Throws:
NullPointerException - if the locale is null.
IllegalArgumentException - if the style is invalid or the locale is not one returned by LocaleServiceProvider.getAvailableLocales()
See Also:
DateFormat.getDateInstance(int,java.util.Locale)

getDateTimeInstance

public abstract DateFormat getDateTimeInstance(int dateStyle,
                                               int timeStyle,
                                               Locale locale)
Returns a DateFormat instance for formatting dates and times with the given style in the specified Locale.

Parameters:
dateStyle - the date formatting style; one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG or DateFormat.FULL.
timeStyle - the time formatting style; one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG or DateFormat.FULL.
locale - the desired locale.
Returns:
the localized instance for formatting dates.
Throws:
NullPointerException - if the locale is null.
IllegalArgumentException - if either style is invalid or the locale is not one returned by LocaleServiceProvider.getAvailableLocales()
See Also:
java.text.DateFormat#getDateInstance(java.util.Locale)

getTimeInstance

public abstract DateFormat getTimeInstance(int style,
                                           Locale locale)
Returns a DateFormat instance for formatting times with the given style in the specified Locale.

Parameters:
style - the formatting style; one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG or DateFormat.FULL.
locale - the desired locale.
Returns:
the localized instance for formatting times.
Throws:
NullPointerException - if the locale is null.
IllegalArgumentException - if the style is invalid or the locale is not one returned by LocaleServiceProvider.getAvailableLocales()
See Also:
DateFormat.getTimeInstance(int,java.util.Locale)