模块 java.base

包 java.text.spi

类 NumberFormatProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.text.spi.NumberFormatProvider

public abstract class NumberFormatProvider extends LocaleServiceProvider 
      

服务提供商的抽象类，提供 NumberFormat 类的具体实现。

自从：

1.6

构造方法总结

构造方法

修饰符	构造方法	描述
protected	NumberFormatProvider()	唯一的构造方法。

方法总结

修饰符和类型	方法	描述
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)	为指定的locale返回一个新的通用 NumberFormat 实例。
abstract NumberFormat	getPercentInstance(Locale locale)	返回一个新的 NumberFormat 实例，它为指定的区域设置格式化百分比值。

在类 java.util.spi.LocaleServiceProvider 中声明的方法

getAvailableLocales, isSupportedLocale

在类 java.lang.Object 中声明的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

NumberFormatProvider

protected NumberFormatProvider()
            

唯一的构造方法。 （对于子类构造方法的调用，通常是隐式的。）

方法详情

getCurrencyInstance

public abstract NumberFormat  getCurrencyInstance(Locale  locale)
            

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

参数：

locale - 所需的locale。

返回：

货币格式化程序

抛出：

NullPointerException - 如果 locale 为空

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

参见：

• NumberFormat.getCurrencyInstance(java.util.Locale)

getIntegerInstance

public abstract NumberFormat  getIntegerInstance(Locale  locale)
            

返回一个新的 NumberFormat 实例，它为指定的locale格式化整数值。返回的数字格式配置为使用半偶数舍入（请参阅 HALF_EVEN ）将浮点数舍入到最接近的整数以进行格式化，并仅解析输入字符串的整数部分（请参阅 isParseIntegerOnly ）。

参数：

locale - 所需的locale

返回：

整数值的数字格式

抛出：

NullPointerException - 如果 locale 为空

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

参见：

• NumberFormat.getIntegerInstance(java.util.Locale)

getNumberInstance

public abstract NumberFormat  getNumberInstance(Locale  locale)
            

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

参数：

locale - 所需的locale

返回：

通用数字格式化程序

抛出：

NullPointerException - 如果 locale 为空

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

参见：

• NumberFormat.getNumberInstance(java.util.Locale)

getPercentInstance

public abstract NumberFormat  getPercentInstance(Locale  locale)
            

返回一个新的 NumberFormat 实例，它为指定的区域设置格式化百分比值。

参数：

locale - 所需的locale

返回：

百分比格式化程序

抛出：

NullPointerException - 如果 locale 为空

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

参见：

• 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() 返回的locale之一。

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

自从：

12

参见：

• NumberFormat.getCompactNumberInstance(Locale, NumberFormat.Style)