compact1, compact2, compact3
java.text.spi
Class NumberFormatProvider
- 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
All Methods Instance Methods Abstract 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, isSupportedLocale
-
-
-
-
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 null -
IllegalArgumentException
- 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 null -
IllegalArgumentException
- 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 null -
IllegalArgumentException
- 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 null -
IllegalArgumentException
- iflocale
isn't one of the locales returned fromgetAvailableLocales()
. - See Also:
-
NumberFormat.getPercentInstance(java.util.Locale)
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.