- java.lang.Object
- java.util.spi.LocaleServiceProvider
- java.text.spi.DateFormatProvider
public abstract class DateFormatProvider extends LocaleServiceProvider
An abstract class for service providers that provide concrete implementations of theDateFormat
class.- Since:
- 1.6
Constructor Summary
Constructors Modifier Constructor Description protected
DateFormatProvider()
Sole constructor.
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description abstract DateFormat
getDateInstance(int style, Locale locale)
Returns a newDateFormat
instance which formats date with the given formatting style for the specified locale.abstract DateFormat
getDateTimeInstance(int dateStyle, int timeStyle, Locale locale)
Returns a newDateFormat
instance which formats date and time with the given formatting style for the specified locale.abstract DateFormat
getTimeInstance(int style, Locale locale)
Returns a newDateFormat
instance which formats time with the given formatting style for the specified locale.Methods declared in class java.util.spi.LocaleServiceProvider
getAvailableLocales, isSupportedLocale
Method Detail
getTimeInstance
public abstract DateFormat getTimeInstance(int style, Locale locale)
Returns a newDateFormat
instance which formats time with the given formatting style for the specified locale.- Parameters:
style
- the given formatting style. Either one ofDateFormat.SHORT
,DateFormat.MEDIUM
,DateFormat.LONG
, orDateFormat.FULL
.locale
- the desired locale.- Returns:
- a time formatter.
- Throws:
IllegalArgumentException
- ifstyle
is invalid, or iflocale
isn't one of the locales returned fromgetAvailableLocales()
.NullPointerException
- iflocale
is null- See Also:
DateFormat.getTimeInstance(int, java.util.Locale)
getDateInstance
public abstract DateFormat getDateInstance(int style, Locale locale)
Returns a newDateFormat
instance which formats date with the given formatting style for the specified locale.- Parameters:
style
- the given formatting style. Either one ofDateFormat.SHORT
,DateFormat.MEDIUM
,DateFormat.LONG
, orDateFormat.FULL
.locale
- the desired locale.- Returns:
- a date formatter.
- Throws:
IllegalArgumentException
- ifstyle
is invalid, or iflocale
isn't one of the locales returned fromgetAvailableLocales()
.NullPointerException
- iflocale
is null- See Also:
DateFormat.getDateInstance(int, java.util.Locale)
getDateTimeInstance
public abstract DateFormat getDateTimeInstance(int dateStyle, int timeStyle, Locale locale)
Returns a newDateFormat
instance which formats date and time with the given formatting style for the specified locale.- Parameters:
dateStyle
- the given date formatting style. Either one ofDateFormat.SHORT
,DateFormat.MEDIUM
,DateFormat.LONG
, orDateFormat.FULL
.timeStyle
- the given time formatting style. Either one ofDateFormat.SHORT
,DateFormat.MEDIUM
,DateFormat.LONG
, orDateFormat.FULL
.locale
- the desired locale.- Returns:
- a date/time formatter.
- Throws:
IllegalArgumentException
- ifdateStyle
ortimeStyle
is invalid, or iflocale
isn't one of the locales returned fromgetAvailableLocales()
.NullPointerException
- iflocale
is null- See Also:
DateFormat.getDateTimeInstance(int, int, java.util.Locale)