Package java.text.spi

Class NumberFormatProvider

java.lang.Object
java.util.spi.LocaleServiceProvider
java.text.spi.NumberFormatProvider
public abstract class NumberFormatProvider
extends LocaleServiceProvider
This abstract class should be extended by service providers that provide NumberFormat instances.

Note that Android does not support user-supplied locale service providers.

Since:
1.6

  • Constructor Details

    • NumberFormatProvider

      protected NumberFormatProvider()
      Default constructor, for use by subclasses.

  • Method Details

    • getCurrencyInstance

      public abstract NumberFormat getCurrencyInstance​(Locale locale)
      Returns an instance of NumberFormat that formats monetary values for the given locale.
      Parameters:
      locale - the locale
      Returns:
      an instance of NumberFormat
      Throws:
      NullPointerException - if locale == null
      IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

    • getIntegerInstance

      public abstract NumberFormat getIntegerInstance​(Locale locale)
      Returns an instance of NumberFormat that formats integer values for the given locale. The returned NumberFormat is configured to round floating point numbers to the nearest integer using half-even rounding mode for formatting, and to parse only the integer part of an input string.
      Parameters:
      locale - the locale
      Returns:
      an instance of NumberFormat
      Throws:
      NullPointerException - if locale == null
      IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

    • getNumberInstance

      public abstract NumberFormat getNumberInstance​(Locale locale)
      Returns an instance of NumberFormat class for general use in the given locale.
      Parameters:
      locale - the locale
      Returns:
      an instance of NumberFormat
      Throws:
      NullPointerException - if locale == null
      IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().

    • getPercentInstance

      public abstract NumberFormat getPercentInstance​(Locale locale)
      Returns an instance of NumberFormat class that formats percentage values for the given locale.
      Parameters:
      locale - the locale
      Returns:
      an instance of NumberFormat
      Throws:
      NullPointerException - if locale == null
      IllegalArgumentException - if locale isn't one of the locales returned from getAvailableLocales().