Class NumberFormatProvider
java.lang.Object
java.util.spi.LocaleServiceProvider
java.text.spi.NumberFormatProvider
An abstract class for service providers that
provide concrete implementations of the
NumberFormat
class.- Since:
- 1.6
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptiongetCompactNumberInstance
(Locale locale, NumberFormat.Style formatStyle) Returns a newNumberFormat
instance which formats a number in its compact form for the specifiedlocale
andformatStyle
.abstract NumberFormat
getCurrencyInstance
(Locale locale) Returns a newNumberFormat
instance which formats monetary values for the specified locale.abstract NumberFormat
getIntegerInstance
(Locale locale) Returns a newNumberFormat
instance which formats integer values for the specified locale.abstract NumberFormat
getNumberInstance
(Locale locale) Returns a new general-purposeNumberFormat
instance for the specified locale.abstract NumberFormat
getPercentInstance
(Locale locale) Returns a newNumberFormat
instance which formats percentage values for the specified locale.Methods declared in class LocaleServiceProvider
getAvailableLocales, isSupportedLocale
Modifier and TypeMethodDescriptionabstract Locale[]
Returns an array of all locales for which this locale service provider can provide localized objects or names.boolean
isSupportedLocale
(Locale locale) Returnstrue
if the givenlocale
is supported by this locale service provider.Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Modifier and TypeMethodDescriptionprotected Object
clone()
Creates and returns a copy of this object.boolean
Indicates whether some other object is "equal to" this one.protected void
finalize()
Deprecated, for removal: This API element is subject to removal in a future version.Finalization is deprecated and subject to removal in a future release.final Class
<?> getClass()
Returns the runtime class of thisObject
.int
hashCode()
Returns a hash code value for this object.final void
notify()
Wakes up a single thread that is waiting on this object's monitor.final void
Wakes up all threads that are waiting on this object's monitor.toString()
Returns a string representation of the object.final void
wait()
Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final void
wait
(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.final void
wait
(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
-
Constructor Details
-
NumberFormatProvider
protected NumberFormatProvider()Sole constructor. (For invocation by subclass constructors, typically implicit.)
-
-
Method Details
-
getCurrencyInstance
Returns a newNumberFormat
instance which formats monetary values for the specified locale.- Parameters:
locale
- the desired locale.- Returns:
- a currency formatter
- Throws:
NullPointerException
- iflocale
is nullIllegalArgumentException
- iflocale
isn't one of the locales returned fromgetAvailableLocales()
.- See Also:
-
getIntegerInstance
Returns a newNumberFormat
instance which formats integer values for the specified locale. The returned number format is configured to round floating point numbers to the nearest integer using half-even rounding (seeHALF_EVEN
) for formatting, and to parse only the integer part of an input string (seeisParseIntegerOnly
).- Parameters:
locale
- the desired locale- Returns:
- a number format for integer values
- Throws:
NullPointerException
- iflocale
is nullIllegalArgumentException
- iflocale
isn't one of the locales returned fromgetAvailableLocales()
.- See Also:
-
getNumberInstance
Returns a new general-purposeNumberFormat
instance for the specified locale.- Parameters:
locale
- the desired locale- Returns:
- a general-purpose number formatter
- Throws:
NullPointerException
- iflocale
is nullIllegalArgumentException
- iflocale
isn't one of the locales returned fromgetAvailableLocales()
.- See Also:
-
getPercentInstance
Returns a newNumberFormat
instance which formats percentage values for the specified locale.- Parameters:
locale
- the desired locale- Returns:
- a percent formatter
- Throws:
NullPointerException
- iflocale
is nullIllegalArgumentException
- iflocale
isn't one of the locales returned fromgetAvailableLocales()
.- See Also:
-
getCompactNumberInstance
Returns a newNumberFormat
instance which formats a number in its compact form for the specifiedlocale
andformatStyle
.- Implementation Requirements:
- The default implementation of this method throws
UnsupportedOperationException
. Overriding the implementation of this method returns the compact number formatter instance of the givenlocale
with specifiedformatStyle
. - Parameters:
locale
- the desired localeformatStyle
- the style for formatting a number- Returns:
- a compact number formatter
- Throws:
NullPointerException
- iflocale
orformatStyle
isnull
IllegalArgumentException
- iflocale
is not one of the locales returned fromgetAvailableLocales()
.UnsupportedOperationException
- if the implementation does not support this method- Since:
- 12
- See Also:
-