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()Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.booleanCompares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.protected voidfinalize()Deprecated, for removal: This API element is subject to removal in a future version.May cause performance issues, deadlocks and hangs.getClass()Answers the unique instance of java.lang.Class which represents the class of the receiver.inthashCode()Answers an integer hash code for the receiver.final voidnotify()Causes one thread which iswaiting on the receiver to be made ready to run.final voidCauses all threads which arewaiting on the receiver to be made ready to run.toString()Answers a string containing a concise, human-readable description of the receiver.final voidwait()Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated bynotifyornotifyAll).final voidwait(long time) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated bynotifyornotifyAll) or the expiration of the timeout.final voidwait(long time, int frac) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated bynotifyornotifyAll) or the expiration of the timeout.
-
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:
-