Package java.text.spi

Class DateFormatProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.text.spi.DateFormatProvider

public abstract class DateFormatProvider
extends LocaleServiceProvider

This abstract class should be extended by service providers that provide instances of DateFormat.

Note that Android does not support user-supplied locale service providers.

Since:

1.6

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DateFormatProvider()	Default constructor, for use by subclasses.

Method Summary

Modifier and Type	Method	Description
abstract DateFormat	getDateInstance(int style, Locale locale)	Returns an instance of DateFormat that formats dates in the given style for the given locale.
abstract DateFormat	getDateTimeInstance(int dateStyle, int timeStyle, Locale locale)	Returns an instance of DateFormat that formats dates and times in the given style for the given locale.
abstract DateFormat	getTimeInstance(int style, Locale locale)	Returns an instance of DateFormat that formats times in the given style for the given 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 Details

DateFormatProvider

protected DateFormatProvider()

Default constructor, for use by subclasses.

Method Details

getTimeInstance

public abstract DateFormat getTimeInstance(int style,
Locale locale)

Returns an instance of DateFormat that formats times in the given style for the given locale.

Parameters:

style - the given time formatting style.

locale - the locale

Returns:

an instance of DateFormat

Throws:

NullPointerException - if locale == null

IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

getDateInstance

public abstract DateFormat getDateInstance(int style,
Locale locale)

Returns an instance of DateFormat that formats dates in the given style for the given locale.

Parameters:

style - the given date formatting style.

locale - the locale

Returns:

an instance of DateFormat

Throws:

NullPointerException - if locale == null

IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

getDateTimeInstance

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

Returns an instance of DateFormat that formats dates and times in the given style for the given locale.

Parameters:

dateStyle - the given date formatting style.

timeStyle - the given time formatting style.

locale - the locale

Returns:

an instance of DateFormat

Throws:

NullPointerException - if locale == null

IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().