public abstract class

DateFormatProvider

extends LocaleServiceProvider
java.lang.Object
   ↳ java.util.spi.LocaleServiceProvider
     ↳ java.text.spi.DateFormatProvider

Class Overview

An abstract class for service providers that provide concrete implementations of the DateFormat class.

Summary

Protected Constructors
DateFormatProvider()
Sole constructor.
Public Methods
abstract DateFormat getDateInstance(int style, Locale locale)
Returns a new DateFormat instance which formats date with the given formatting style for the specified locale.
abstract DateFormat getDateTimeInstance(int dateStyle, int timeStyle, Locale locale)
Returns a new DateFormat instance which formats date and time with the given formatting style for the specified locale.
abstract DateFormat getTimeInstance(int style, Locale locale)
Returns a new DateFormat instance which formats time with the given formatting style for the specified locale.
[Expand]
Inherited Methods
From class java.util.spi.LocaleServiceProvider
From class java.lang.Object

Protected Constructors

protected DateFormatProvider ()

Sole constructor. (For invocation by subclass constructors, typically implicit.)

Public Methods

public abstract DateFormat getDateInstance (int style, Locale locale)

Returns a new DateFormat instance which formats date with the given formatting style for the specified locale.

Parameters
style the given formatting style. Either one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG, or DateFormat.FULL.
locale the desired locale.
Returns
  • a date formatter.
Throws
IllegalArgumentException if style is invalid, or if locale isn't one of the locales returned from getAvailableLocales().
NullPointerException if locale is null

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

Returns a new DateFormat instance which formats date and time with the given formatting style for the specified locale.

Parameters
dateStyle the given date formatting style. Either one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG, or DateFormat.FULL.
timeStyle the given time formatting style. Either one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG, or DateFormat.FULL.
locale the desired locale.
Returns
  • a date/time formatter.
Throws
IllegalArgumentException if dateStyle or timeStyle is invalid, or if locale isn't one of the locales returned from getAvailableLocales().
NullPointerException if locale is null

public abstract DateFormat getTimeInstance (int style, Locale locale)

Returns a new DateFormat instance which formats time with the given formatting style for the specified locale.

Parameters
style the given formatting style. Either one of DateFormat.SHORT, DateFormat.MEDIUM, DateFormat.LONG, or DateFormat.FULL.
locale the desired locale.
Returns
  • a time formatter.
Throws
IllegalArgumentException if style is invalid, or if locale isn't one of the locales returned from getAvailableLocales().
NullPointerException if locale is null