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 newNumberFormatinstance which formats a number in its compact form for the specifiedlocaleandformatStyle.abstract NumberFormatgetCurrencyInstance(Locale locale) Returns a newNumberFormatinstance which formats monetary values for the specified locale.abstract NumberFormatgetIntegerInstance(Locale locale) Returns a newNumberFormatinstance which formats integer values for the specified locale.abstract NumberFormatgetNumberInstance(Locale locale) Returns a new general-purposeNumberFormatinstance for the specified locale.abstract NumberFormatgetPercentInstance(Locale locale) Returns a newNumberFormatinstance which formats percentage values for the specified locale.Methods declared in class LocaleServiceProvider
getAvailableLocales, isSupportedLocaleModifier and TypeMethodDescriptionabstract Locale[]Returns an array of all locales for which this locale service provider can provide localized objects or names.booleanisSupportedLocale(Locale locale) Returnstrueif the givenlocaleis supported by this locale service provider.Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitModifier and TypeMethodDescriptionprotected Objectclone()Creates and returns a copy of this object.booleanIndicates whether some other object is "equal to" this one.protected voidfinalize()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.inthashCode()Returns a hash code value for this object.final voidnotify()Wakes up a single thread that is waiting on this object's monitor.final voidWakes up all threads that are waiting on this object's monitor.toString()Returns a string representation of the object.final voidwait()Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final voidwait(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 voidwait(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 newNumberFormatinstance which formats monetary values for the specified locale.- Parameters:
locale- the desired locale.- Returns:
- a currency formatter
- Throws:
NullPointerException- iflocaleis nullIllegalArgumentException- iflocaleisn't one of the locales returned fromgetAvailableLocales().- See Also:
-
getIntegerInstance
Returns a newNumberFormatinstance 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- iflocaleis nullIllegalArgumentException- iflocaleisn't one of the locales returned fromgetAvailableLocales().- See Also:
-
getNumberInstance
Returns a new general-purposeNumberFormatinstance for the specified locale.- Parameters:
locale- the desired locale- Returns:
- a general-purpose number formatter
- Throws:
NullPointerException- iflocaleis nullIllegalArgumentException- iflocaleisn't one of the locales returned fromgetAvailableLocales().- See Also:
-
getPercentInstance
Returns a newNumberFormatinstance which formats percentage values for the specified locale.- Parameters:
locale- the desired locale- Returns:
- a percent formatter
- Throws:
NullPointerException- iflocaleis nullIllegalArgumentException- iflocaleisn't one of the locales returned fromgetAvailableLocales().- See Also:
-
getCompactNumberInstance
Returns a newNumberFormatinstance which formats a number in its compact form for the specifiedlocaleandformatStyle.- Implementation Requirements:
- The default implementation of this method throws
UnsupportedOperationException. Overriding the implementation of this method returns the compact number formatter instance of the givenlocalewith specifiedformatStyle. - Parameters:
locale- the desired localeformatStyle- the style for formatting a number- Returns:
- a compact number formatter
- Throws:
NullPointerException- iflocaleorformatStyleisnullIllegalArgumentException- iflocaleis not one of the locales returned fromgetAvailableLocales().UnsupportedOperationException- if the implementation does not support this method- Since:
- 12
- See Also:
-