Class DateFormatProvider
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 the
DateFormat
class.- Since:
- 1.6
Constructor Summary
Modifier | Constructor | Description |
---|---|---|
protected |
Sole constructor. |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
abstract DateFormat |
getDateInstance |
Returns a new DateFormat instance which formats date with the given formatting style for the specified locale. |
abstract DateFormat |
getDateTimeInstance |
Returns a new DateFormat instance which formats date and time with the given formatting style for the specified locale. |
abstract DateFormat |
getTimeInstance |
Returns a new DateFormat instance which formats time with the given formatting style for the specified locale. |
Methods declared in class java.util.spi.LocaleServiceProvider
getAvailableLocales, isSupportedLocale
Constructor Details
DateFormatProvider
protected DateFormatProvider()
Sole constructor. (For invocation by subclass constructors, typically implicit.)
Method Details
getTimeInstance
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 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:
getDateInstance
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 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:
getDateTimeInstance
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 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:
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/text/spi/DateFormatProvider.html