class:NumberFormatProvider [NONE]

public abstract class NumberFormatProviderextends LocaleServiceProvider

An abstract class for service providers that provide concrete implementations of the NumberFormat class.

Since:: 1.6

constructor:NumberFormatProvider() [NONE]

NumberFormatProvider

protected NumberFormatProvider()

Sole constructor. (For invocation by subclass constructors, typically implicit.)

method:getCurrencyInstance(java.util.Locale) [NONE]

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 - if locale is null

IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

See Also:

method:getIntegerInstance(java.util.Locale) [NONE]

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 - if locale is null

IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

See Also:

method:getNumberInstance(java.util.Locale) [NONE]

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 - if locale is null

IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

See Also:

method:getPercentInstance(java.util.Locale) [NONE]

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 - if locale is null

IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

See Also:

method:getCompactNumberInstance(java.util.Locale,java.text.NumberFormat.Style) [NONE]

getCompactNumberInstance

public NumberFormat getCompactNumberInstance (Locale locale, NumberFormat.Style formatStyle)

Returns a new NumberFormat instance which formats a number in its compact form for the specified locale and formatStyle.

Implementation Requirements:

The default implementation of this method throws UnsupportedOperationException. Overriding the implementation of this method returns the compact number formatter instance of the given locale with specified formatStyle.

Parameters:

locale - the desired locale

formatStyle - the style for formatting a number

Returns:

a compact number formatter

Throws:

NullPointerException - if locale or formatStyle is null

IllegalArgumentException - if locale is not one of the locales returned from getAvailableLocales().

UnsupportedOperationException - if the implementation does not support this method

Since:

See Also: