- java.lang.Object
-
- java.util.spi.LocaleServiceProvider
-
- java.text.spi.NumberFormatProvider
-
public abstract class NumberFormatProvider extends LocaleServiceProvider
An abstract class for service providers that provide concrete implementations of theNumberFormat
class.- Since:
- 1.6
-
-
Constructor Summary
Constructors Modifier Constructor and Description protected
NumberFormatProvider()
Sole constructor.
-
Method Summary
Methods Modifier and Type Method and Description 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 inherited from class java.util.spi.LocaleServiceProvider
getAvailableLocales
-
-
-
-
Constructor Detail
-
NumberFormatProvider
protected NumberFormatProvider()
Sole constructor. (For invocation by subclass constructors, typically implicit.)
-
-
Method Detail
-
getCurrencyInstance
public abstract NumberFormat getCurrencyInstance(Locale locale)
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:
NumberFormat.getCurrencyInstance(java.util.Locale)
-
getIntegerInstance
public abstract NumberFormat getIntegerInstance(Locale locale)
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:
NumberFormat.getIntegerInstance(java.util.Locale)
-
getNumberInstance
public abstract NumberFormat getNumberInstance(Locale locale)
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:
NumberFormat.getNumberInstance(java.util.Locale)
-
getPercentInstance
public abstract NumberFormat getPercentInstance(Locale locale)
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:
NumberFormat.getPercentInstance(java.util.Locale)
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/text/spi/numberformatprovider.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.