com.feilong.core.text

Class NumberFormatUtil

java.lang.Object

com.feilong.core.text.NumberFormatUtil

public final class NumberFormatUtil
extends Object

NumberFormat是所有数值格式的抽象基类,此类提供格式化和解析数值的接口.

直接已知子类: ChoiceFormat, DecimalFormat.
注意:DecimalFormat不是同步的 ,建议为每个线程创建独立的格式实例.(见JAVA API 文档)

Since:

1.0.2

Author:

feilong

See Also:

Format, NumberFormat, DecimalFormat, NumberPattern

Method Summary

Methods

Modifier and Type	Method and Description
static String	format(Number value, String numberPattern, RoundingMode roundingMode) 将 Number 使用 RoundingMode numberPattern格式化.

Methods inherited from class java.lang.Object

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

Method Detail

format

public static String format(Number value,
            String numberPattern,
            RoundingMode roundingMode)

将 Number 使用 RoundingMode numberPattern格式化.

示例:

 NumberFormatUtil.format(toBigDecimal(1.15), "#####.#",null)     =   1.2
 NumberFormatUtil.format(toBigDecimal(1.25), "#####.#",null)     =   1.3
 NumberFormatUtil.format(toBigDecimal(1.251), "#####.#",null)    =   1.3
 
 NumberFormatUtil.format(toBigDecimal(-1.15), "#####.#",null)    =   -1.2
 NumberFormatUtil.format(toBigDecimal(-1.25), "#####.#",null)    =   -1.3
 NumberFormatUtil.format(toBigDecimal(-1.251), "#####.#",null)   =   -1.3
 
 
 NumberFormatUtil.format(toBigDecimal(1.15), "#####.#", RoundingMode.HALF_EVEN)     =   1.2
 NumberFormatUtil.format(toBigDecimal(1.25), "#####.#", RoundingMode.HALF_EVEN)     =   1.2
 NumberFormatUtil.format(toBigDecimal(1.251), "#####.#", RoundingMode.HALF_EVEN)    =   1.3
 
 NumberFormatUtil.format(toBigDecimal(-1.15), "#####.#", RoundingMode.HALF_EVEN)    =   -1.2
 NumberFormatUtil.format(toBigDecimal(-1.25), "#####.#", RoundingMode.HALF_EVEN)    =   -1.2
 NumberFormatUtil.format(toBigDecimal(-1.251), "#####.#", RoundingMode.HALF_EVEN)   =   -1.3
 

关于参数 value:

请尽量传递Integer,Long,BigDecimal,而不要使用 float,double等浮点类型,否则可能结果不准确,特别是jdk8以下的版本,具体参见 NumberFormatUtilTest 在 jdk8 下面测试不通过

关于参数 roundingMode

虽然DecimalFormat,默认使用的是银行家舍入法 RoundingMode.HALF_EVEN,参见 关于 RoundingMode#HALF_EVEN

但是我们常用标准的四舍五入,为了保持和 NumberUtil.toString(Number, String)一致性,如果 roundingMode 为null,使用常用的 RoundingMode.HALF_UP来进行格式化

Parameters:

value - the value

numberPattern - 格式化数字格式,可以参见或者使用NumberPattern

roundingMode - 舍入模式RoundingMode,如果 为null,使用常用的 RoundingMode.HALF_UP

Returns:

如果 value 是null,抛出 NullPointerException
如果 numberPattern 是null,抛出 NullPointerException
如果 numberPattern 是blank,抛出 IllegalArgumentException

See Also:

DecimalFormat, JAVA 8种舍入法