NumberUtil (lt-monitor-core 0.3.6 API)

java.lang.Object
- cn.slipi.monitor.core.util.NumberUtil

```
public class NumberUtil
extends Object
```
数字工具类
对于精确值计算应该使用 BigDecimal
JDK7中BigDecimal(double val)构造方法的结果有一定的不可预知性，例如：
```
 new BigDecimal(0.1)
 
```
表示的不是0.1而是0.1000000000000000055511151231257827021181583404541015625
这是因为0.1无法准确的表示为double。因此应该使用new BigDecimal(String)。
相关介绍：
- http://www.oschina.net/code/snippet_563112_25237
- https://github.com/venusdrogon/feilong-core/wiki/one-jdk7-bug-thinking
作者:

Looly

构造器概要

构造器
构造器和说明

NumberUtil()

构造器
构造器和说明
`NumberUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static BigDecimal`	`div(BigDecimal v1, BigDecimal v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static double`	`div(double v1, double v2)` 提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
`static double`	`div(Double v1, Double v2)` 提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
`static double`	`div(double v1, double v2, int scale)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
`static double`	`div(Double v1, Double v2, int scale)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
`static double`	`div(double v1, double v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static double`	`div(Double v1, Double v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static double`	`div(double v1, float v2)` 提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
`static double`	`div(double v1, float v2, int scale)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
`static double`	`div(double v1, float v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static double`	`div(float v1, double v2)` 提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
`static double`	`div(float v1, double v2, int scale)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
`static double`	`div(float v1, double v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static double`	`div(float v1, float v2)` 提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
`static double`	`div(float v1, float v2, int scale)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
`static double`	`div(float v1, float v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static BigDecimal`	`div(Number v1, Number v2)` 提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
`static BigDecimal`	`div(Number v1, Number v2, int scale)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
`static BigDecimal`	`div(Number v1, Number v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static BigDecimal`	`div(String v1, String v2)` 提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
`static BigDecimal`	`div(String v1, String v2, int scale)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
`static BigDecimal`	`div(String v1, String v2, int scale, RoundingMode roundingMode)` 提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
`static BigDecimal`	`mul(BigDecimal... values)` 提供精确的乘法运算如果传入多个值为null或者空，则返回0
`static double`	`mul(double v1, double v2)` 提供精确的乘法运算
`static double`	`mul(Double v1, Double v2)` 提供精确的乘法运算如果传入多个值为null或者空，则返回0
`static double`	`mul(double v1, float v2)` 提供精确的乘法运算
`static double`	`mul(float v1, double v2)` 提供精确的乘法运算
`static double`	`mul(float v1, float v2)` 提供精确的乘法运算
`static BigDecimal`	`mul(Number... values)` 提供精确的乘法运算如果传入多个值为null或者空，则返回0
`static BigDecimal`	`mul(Number v1, Number v2)` 提供精确的乘法运算如果传入多个值为null或者空，则返回0
`static BigDecimal`	`mul(String... values)` 提供精确的乘法运算如果传入多个值为null或者空，则返回0
`static BigDecimal`	`mul(String v1, String v2)` 提供精确的乘法运算
`static Number`	`parseNumber(String numberStr)` 将指定字符串转换为`Number` 对象此方法不支持科学计数法
`static BigDecimal`	`round(BigDecimal number, int scale)` 保留固定位数小数采用四舍五入策略 `RoundingMode.HALF_UP` 例如保留2位小数：123.456789 =》 123.46
`static BigDecimal`	`round(BigDecimal number, int scale, RoundingMode roundingMode)` 保留固定位数小数例如保留四位小数：123.456789 =》 123.4567
`static BigDecimal`	`round(double v, int scale)` 保留固定位数小数采用四舍五入策略 `RoundingMode.HALF_UP` 例如保留2位小数：123.456789 =》 123.46
`static BigDecimal`	`round(double v, int scale, RoundingMode roundingMode)` 保留固定位数小数例如保留四位小数：123.456789 =》 123.4567
`static BigDecimal`	`round(String numberStr, int scale, RoundingMode roundingMode)` 保留固定位数小数例如保留四位小数：123.456789 =》 123.4567
`static BigDecimal`	`roundDown(BigDecimal value, int scale)` 保留固定小数位数，舍去多余位数
`static BigDecimal`	`roundHalfEven(BigDecimal value, int scale)` 四舍六入五成双计算法四舍六入五成双是一种比较精确比较科学的计数保留法，是一种数字修约规则。
`static BigDecimal`	`toBigDecimal(String numberStr)` 数字转`BigDecimal` null或""或空白符转换为0

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - NumberUtil
```
public NumberUtil()
```
- 方法详细资料
  - mul
```
public static double mul(float v1,
                         float v2)
```
    提供精确的乘法运算
    
    参数:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    返回:
    
    积
  - mul
```
public static double mul(float v1,
                         double v2)
```
    提供精确的乘法运算
    
    参数:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    返回:
    
    积
  - mul
```
public static double mul(double v1,
                         float v2)
```
    提供精确的乘法运算
    
    参数:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    返回:
    
    积
  - mul
```
public static double mul(double v1,
                         double v2)
```
    提供精确的乘法运算
    
    参数:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    返回:
    
    积
  - mul
```
public static double mul(Double v1,
                         Double v2)
```
    提供精确的乘法运算
    如果传入多个值为null或者空，则返回0
    
    参数:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    返回:
    
    积
  - mul
```
public static BigDecimal mul(Number v1,
                             Number v2)
```
    提供精确的乘法运算
    如果传入多个值为null或者空，则返回0
    
    参数:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    返回:
    
    积
  - mul
```
public static BigDecimal mul(Number... values)
```
    提供精确的乘法运算
    如果传入多个值为null或者空，则返回0
    
    参数:
    
    values - 多个被乘值
    
    返回:
    
    积
    
    从以下版本开始:
    
    4.0.0
  - mul
```
public static BigDecimal mul(String v1,
                             String v2)
```
    提供精确的乘法运算
    
    参数:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    返回:
    
    积
    
    从以下版本开始:
    
    3.0.8
  - mul
```
public static BigDecimal mul(String... values)
```
    提供精确的乘法运算
    如果传入多个值为null或者空，则返回0
    
    参数:
    
    values - 多个被乘值
    
    返回:
    
    积
    
    从以下版本开始:
    
    4.0.0
  - mul
```
public static BigDecimal mul(BigDecimal... values)
```
    提供精确的乘法运算
    如果传入多个值为null或者空，则返回0
    
    参数:
    
    values - 多个被乘值
    
    返回:
    
    积
    
    从以下版本开始:
    
    4.0.0
  - div
```
public static double div(float v1,
                         float v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    返回:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         double v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    返回:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         float v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    返回:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         double v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    返回:
    
    两个参数的商
  - div
```
public static double div(Double v1,
                         Double v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    返回:
    
    两个参数的商
  - div
```
public static BigDecimal div(Number v1,
                             Number v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    返回:
    
    两个参数的商
    
    从以下版本开始:
    
    3.1.0
  - div
```
public static BigDecimal div(String v1,
                             String v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    返回:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         float v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    返回:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         double v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    返回:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         float v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    返回:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         double v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    返回:
    
    两个参数的商
  - div
```
public static double div(Double v1,
                         Double v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    返回:
    
    两个参数的商
  - div
```
public static BigDecimal div(Number v1,
                             Number v2,
                             int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    返回:
    
    两个参数的商
    
    从以下版本开始:
    
    3.1.0
  - div
```
public static BigDecimal div(String v1,
                             String v2,
                             int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    返回:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         float v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         double v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         float v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         double v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
  - div
```
public static double div(Double v1,
                         Double v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
  - div
```
public static BigDecimal div(Number v1,
                             Number v2,
                             int scale,
                             RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
    
    从以下版本开始:
    
    3.1.0
  - div
```
public static BigDecimal div(String v1,
                             String v2,
                             int scale,
                             RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
  - div
```
public static BigDecimal div(BigDecimal v1,
                             BigDecimal v2,
                             int scale,
                             RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    参数:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度，如果为负值，取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    两个参数的商
    
    从以下版本开始:
    
    3.0.9
  - round
```
public static BigDecimal round(BigDecimal number,
                               int scale)
```
    保留固定位数小数
    采用四舍五入策略 RoundingMode.HALF_UP
    例如保留2位小数：123.456789 =》 123.46
    
    参数:
    
    number - 数字值
    
    scale - 保留小数位数
    
    返回:
    
    新值
    
    从以下版本开始:
    
    4.1.0
  - round
```
public static BigDecimal round(BigDecimal number,
                               int scale,
                               RoundingMode roundingMode)
```
    保留固定位数小数
    例如保留四位小数：123.456789 =》 123.4567
    
    参数:
    
    number - 数字值
    
    scale - 保留小数位数，如果传入小于0，则默认0
    
    roundingMode - 保留小数的模式 RoundingMode，如果传入null则默认四舍五入
    
    返回:
    
    新值
  - round
```
public static BigDecimal round(double v,
                               int scale)
```
    保留固定位数小数
    采用四舍五入策略 RoundingMode.HALF_UP
    例如保留2位小数：123.456789 =》 123.46
    
    参数:
    
    v - 值
    
    scale - 保留小数位数
    
    返回:
    
    新值
  - round
```
public static BigDecimal round(double v,
                               int scale,
                               RoundingMode roundingMode)
```
    保留固定位数小数
    例如保留四位小数：123.456789 =》 123.4567
    
    参数:
    
    v - 值
    
    scale - 保留小数位数
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    新值
  - round
```
public static BigDecimal round(String numberStr,
                               int scale,
                               RoundingMode roundingMode)
```
    保留固定位数小数
    例如保留四位小数：123.456789 =》 123.4567
    
    参数:
    
    numberStr - 数字值的字符串表现形式
    
    scale - 保留小数位数，如果传入小于0，则默认0
    
    roundingMode - 保留小数的模式 RoundingMode，如果传入null则默认四舍五入
    
    返回:
    
    新值
  - roundHalfEven
```
public static BigDecimal roundHalfEven(BigDecimal value,
                                       int scale)
```
    四舍六入五成双计算法
    四舍六入五成双是一种比较精确比较科学的计数保留法，是一种数字修约规则。
```
 算法规则:
 四舍六入五考虑，
 五后非零就进一，
 五后皆零看奇偶，
 五前为偶应舍去，
 五前为奇要进一。
 
```
    参数:
    
    value - 需要科学计算的数据
    
    scale - 保留的小数位
    
    返回:
    
    结果
    
    从以下版本开始:
    
    4.1.0
  - roundDown
```
public static BigDecimal roundDown(BigDecimal value,
                                   int scale)
```
    保留固定小数位数，舍去多余位数
    
    参数:
    
    value - 需要科学计算的数据
    
    scale - 保留的小数位
    
    返回:
    
    结果
    
    从以下版本开始:
    
    4.1.0
  - toBigDecimal
```
public static BigDecimal toBigDecimal(String numberStr)
```
    数字转BigDecimal
    null或""或空白符转换为0
    
    参数:
    
    numberStr - 数字字符串
    
    返回:
    
    BigDecimal
    
    从以下版本开始:
    
    4.0.9
  - parseNumber
```
public static Number parseNumber(String numberStr)
                          throws NumberFormatException
```
    将指定字符串转换为Number 对象
    此方法不支持科学计数法
    
    参数:
    
    numberStr - Number字符串
    
    返回:
    
    Number对象
    
    抛出:
    
    NumberFormatException - 包装了ParseException，当给定的数字字符串无法解析时抛出
    
    从以下版本开始:
    
    4.1.15

类 NumberUtil

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

NumberUtil

方法详细资料

mul

mul

mul

mul

mul

mul

mul

mul

mul

mul

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

div

round

round

round

round

round

roundHalfEven

roundDown

toBigDecimal

parseNumber