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 the NumberFormat
class.
- Since:
- 1.6
Constructor Summary
Modifier | Constructor | Description |
---|---|---|
protected | NumberFormatProvider() | Sole constructor. |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
abstract NumberFormat | getCurrencyInstance(Locale locale) | Returns a new |
abstract NumberFormat | getIntegerInstance(Locale locale) | Returns a new |
abstract NumberFormat | getNumberInstance(Locale locale) | Returns a new general-purpose |
abstract NumberFormat | getPercentInstance(Locale locale) | Returns a new |
Methods declared in class java.util.spi.LocaleServiceProvider
getAvailableLocales, isSupportedLocale
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
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 new NumberFormat
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 new NumberFormat
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 (see HALF_EVEN
) for formatting, and to parse only the integer part of an input string (see isParseIntegerOnly
).
- 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-purpose NumberFormat
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 new NumberFormat
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)