java.text.spi

Class DateFormatProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.text.spi.DateFormatProvider

public abstract class DateFormatProvider
extends LocaleServiceProvider

A DateFormatProvider provides localized instances of DateFormat.

Since:

1.6

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DateFormatProvider() Constructs a new DateFormatProvider.

Method Summary

Methods

Modifier and Type	Method and Description
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)