Module java.base

Package java.text.spi

Class NumberFormatProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.text.spi.NumberFormatProvider

       public abstract class NumberFormatProvider extends LocaleServiceProvider
      

一个为服务提供者提供具体实现的NumberFormat类的抽象类。

自版本:

1.6

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	NumberFormatProvider()	唯一构造函数。

Method Summary

Modifier and Type	Method	Description
NumberFormat	getCompactNumberInstance(Locale locale, NumberFormat.Style formatStyle)	返回一个新的NumberFormat实例，用于为指定的locale和formatStyle格式化数字的紧凑形式。
abstract NumberFormat	getCurrencyInstance(Locale locale)	返回一个新的NumberFormat实例，用于为指定的locale格式化货币值。
abstract NumberFormat	getIntegerInstance(Locale locale)	返回一个新的NumberFormat实例，用于为指定的locale格式化整数值。
abstract NumberFormat	getNumberInstance(Locale locale)	返回一个新的通用NumberFormat实例，用于指定的locale。
abstract NumberFormat	getPercentInstance(Locale locale)	返回一个新的NumberFormat实例，用于为指定的locale格式化百分比值。

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 Details

NumberFormatProvider

             protected NumberFormatProvider()
            

唯一构造函数。（通常由子类构造函数隐式调用。）

Method Details

getCurrencyInstance

             public abstract NumberFormat getCurrencyInstance(Locale locale)
            

返回一个新的NumberFormat实例，用于为指定的locale格式化货币值。

参数:

locale - 所需的locale。

返回:

一个货币格式化程序

抛出:

NullPointerException - 如果locale为null

IllegalArgumentException - 如果locale不是从getAvailableLocales()返回的区域设置之一。

参见:

• NumberFormat.getCurrencyInstance(java.util.Locale)

getIntegerInstance

             public abstract NumberFormat getIntegerInstance(Locale locale)
            

返回一个新的NumberFormat实例，用于为指定的locale格式化整数值。返回的数字格式已配置为使用半偶数舍入（参见HALF_EVEN）来将浮点数四舍五入到最接近的整数，以及仅解析输入字符串的整数部分（参见isParseIntegerOnly）。

参数:

locale - 所需的locale

返回:

一个整数值的数字格式

抛出:

NullPointerException - 如果locale为null

IllegalArgumentException - 如果locale不是从getAvailableLocales()返回的区域设置之一。

参见:

• NumberFormat.getIntegerInstance(java.util.Locale)

getNumberInstance

             public abstract NumberFormat getNumberInstance(Locale locale)
            

返回一个新的通用NumberFormat实例，用于指定的locale。

参数:

locale - 所需的locale

返回:

一个通用数字格式化程序

抛出:

NullPointerException - 如果locale为null

IllegalArgumentException - 如果locale不是从getAvailableLocales()返回的区域设置之一。

参见:

• NumberFormat.getNumberInstance(java.util.Locale)

getPercentInstance

             public abstract NumberFormat getPercentInstance(Locale locale)
            

返回一个新的NumberFormat实例，用于为指定的locale格式化百分比值。

参数:

locale - 所需的locale

返回:

一个百分比格式化程序

抛出:

NullPointerException - 如果locale为null

IllegalArgumentException - 如果locale不是从getAvailableLocales()返回的区域设置之一。

参见:

• NumberFormat.getPercentInstance(java.util.Locale)

getCompactNumberInstance

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

返回一个新的NumberFormat实例，用于为指定的locale和formatStyle格式化数字的紧凑形式。

实现要求:

此方法的默认实现会抛出UnsupportedOperationException。重写此方法的实现将返回给定locale的紧凑数字格式化程序实例，带有指定的formatStyle。

参数:

locale - 所需的locale

formatStyle - 用于格式化数字的样式

返回:

一个紧凑数字格式化程序

抛出:

NullPointerException - 如果locale或formatStyle为null

IllegalArgumentException - 如果locale不是从getAvailableLocales()返回的区域设置之一。

UnsupportedOperationException - 如果实现不支持此方法

自版本:

12

参见:

• NumberFormat.getCompactNumberInstance(Locale, NumberFormat.Style)