NumberUtils (bus-all 5.2.8 API)

java.lang.Object
- org.aoju.bus.core.utils.NumberUtils

```
public class NumberUtils
extends Object
```
数字工具类对于精确值计算应该使用 BigDecimal JDK7中BigDecimal(double val)构造方法的结果有一定的不可预知性,例如：
```
 new BigDecimal(0.1)
 
```
表示的不是0.1而是0.1000000000000000055511151231257827021181583404541015625
这是因为0.1无法准确的表示为double 因此应该使用new BigDecimal(String)
Since:

JDK 1.8+

Version:

5.2.8

Author:

Kimi Liu

Constructor Summary

Constructors
Constructor and Description

NumberUtils()

Constructors
Constructor and Description
`NumberUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static BigDecimal`	`add(BigDecimal... values)` 提供精确的加法运算如果传入多个值为null或者空,则返回0
`static double`	`add(double v1, double v2)` 提供精确的加法运算
`static double`	`add(double v1, float v2)` 提供精确的加法运算
`static double`	`add(float v1, double v2)` 提供精确的加法运算
`static double`	`add(float v1, float v2)` 提供精确的加法运算
`static BigDecimal`	`add(Number... values)` 提供精确的加法运算如果传入多个值为null或者空,则返回0
`static BigDecimal`	`add(Number v1, Number v2)` 提供精确的加法运算如果传入多个值为null或者空,则返回0
`static BigDecimal`	`add(String... values)` 提供精确的加法运算如果传入多个值为null或者空,则返回0
`static String`	`addZero(Number numObj, int length)` 给数字对象按照指定长度在左侧补0.
`static Collection<Integer>`	`appendRange(int start, int stop, Collection<Integer> values)` 将给定范围内的整数添加到已有集合中,步进为1
`static Collection<Integer>`	`appendRange(int start, int stop, int step, Collection<Integer> values)` 将给定范围内的整数添加到已有集合中
`static int`	`binaryToInt(String binaryStr)` 二进制转int
`static long`	`binaryToLong(String binaryStr)` 二进制转long
`static int`	`compare(byte x, byte y)` 比较两个值的大小
`static int`	`compare(char x, char y)` 比较两个值的大小
`static int`	`compare(double x, double y)` 比较两个值的大小
`static int`	`compare(int x, int y)` 比较两个值的大小
`static int`	`compare(long x, long y)` 比较两个值的大小
`static int`	`compare(short x, short y)` 比较两个值的大小
`static int`	`count(int total, int part)` 计算等份个数
`static String`	`decimalFormat(String pattern, double value)` 格式化double 对 `DecimalFormat` 做封装
`static String`	`decimalFormat(String pattern, long value)` 格式化double 对 `DecimalFormat` 做封装
`static String`	`decimalFormatMoney(double value)` 格式化金额输出,每三位用逗号分隔
`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, 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 int`	`divisor(int m, int n)` 最大公约数
`static boolean`	`equals(char c1, char c2, boolean ignoreCase)` 比较两个字符是否相同
`static long`	`factorial(long n)` 计算阶乘
`static long`	`factorial(long start, long end)` 计算阶乘
`static String`	`formatPercent(double number, int scale)` 格式化百分比,小数采用四舍五入方式
`static Integer[]`	`generateBySet(int begin, int end, int size)` 生成不重复随机数根据给定的最小数字和最大数字,以及随机数的个数,产生指定的不重复的数组
`static int[]`	`generateRandomNumber(int begin, int end, int size)` 生成不重复随机数根据给定的最小数字和最大数字,以及随机数的个数,产生指定的不重复的数组
`static String`	`getBinaryStr(Number number)` 获得数字对应的二进制字符串
`static boolean`	`isBeside(int number1, int number2)` 判断两个数字是否相邻,例如1和2相邻,1和3不相邻判断方法为做差取绝对值判断是否为1
`static boolean`	`isBeside(long number1, long number2)` 判断两个数字是否相邻,例如1和2相邻,1和3不相邻判断方法为做差取绝对值判断是否为1
`static boolean`	`isDouble(String s)` 判断字符串是否是浮点数
`static boolean`	`isInteger(String s)` 判断String是否是整数
`static boolean`	`isLong(String s)` 判断字符串是否是Long类型
`static boolean`	`isNumber(String str)` 是否为数字
`static boolean`	`isPrimes(int n)` 是否是质数质数表的质数又称素数指整数在一个大于1的自然数中,除了1和此整数自身外,没法被其他自然数整除的数
`static double`	`max(double... numberArray)` 取最大值
`static float`	`max(float... numberArray)` 取最大值
`static int`	`max(int... numberArray)` 取最大值
`static long`	`max(long... numberArray)` 取最大值
`static short`	`max(short... numberArray)` 取最大值
`static <T extends Comparable<? super T>> T`	`max(T... numberArray)` 取最大值
`static double`	`min(double... numberArray)` 取最小值
`static float`	`min(float... numberArray)` 取最小值
`static int`	`min(int... numberArray)` 取最小值
`static long`	`min(long... numberArray)` 取最小值
`static short`	`min(short... numberArray)` 取最小值
`static <T extends Comparable<? super T>> T`	`min(T... numberArray)` 取最小值
`static BigDecimal`	`mul(BigDecimal... values)` 提供精确的乘法运算如果传入多个值为null或者空,则返回0
`static double`	`mul(double v1, double v2)` 提供精确的乘法运算
`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 int`	`multiple(int m, int n)` 最小公倍数
`static BigInteger`	`newBigInteger(String str)` 创建`BigInteger`,支持16进制、10进制和8进制,如果传入空白串返回null from Apache Common Lang
`static BigDecimal`	`null2Zero(BigDecimal decimal)` 空转0
`static int`	`parseInt(String number)` 解析转换数字字符串为int型数字,规则如下：
`static long`	`parseLong(String number)` 解析转换数字字符串为long型数字,规则如下：
`static Number`	`parseNumber(String numberStr)` 将指定字符串转换为`Number` 对象
`static int`	`partValue(int total, int partCount)` 把给定的总数平均分成N份,返回每份的个数当除以分数有余数时每份+1
`static int`	`partValue(int total, int partCount, boolean isPlusOneWhenHasRem)` 把给定的总数平均分成N份,返回每份的个数如果isPlusOneWhenHasRem为true,则当除以分数有余数时每份+1,否则丢弃余数部分
`static BigDecimal`	`pow(BigDecimal number, int n)` 提供精确的幂运算
`static BigDecimal`	`pow(Number number, int n)` 提供精确的幂运算
`static int`	`processMultiple(int selectNum, int minNum)` 可以用于计算双色球、大乐透注数的方法比如大乐透35选5可以这样调用processMultiple(7,5); 就是数学中的：C75=76/21
`static int[]`	`range(int stop)` 从0开始给定范围内的整数列表,步进为1
`static int[]`	`range(int start, int stop)` 给定范围内的整数列表,步进为1
`static int[]`	`range(int start, int stop, int step)` 给定范围内的整数列表
`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`	`roundDown(BigDecimal value, int scale)` 保留固定小数位数,舍去多余位数
`static BigDecimal`	`roundDown(Number number, int scale)` 保留固定小数位数,舍去多余位数
`static BigDecimal`	`roundHalfEven(BigDecimal value, int scale)` 四舍六入五成双计算法
`static BigDecimal`	`roundHalfEven(Number number, int scale)` 四舍六入五成双计算法
`static long`	`sqrt(long x)` 平方根算法推荐使用 `Math.sqrt(double)`
`static BigDecimal`	`sub(BigDecimal... values)` 提供精确的减法运算如果传入多个值为null或者空,则返回0
`static double`	`sub(double v1, double v2)` 提供精确的减法运算
`static double`	`sub(double v1, float v2)` 提供精确的减法运算
`static double`	`sub(float v1, double v2)` 提供精确的减法运算
`static double`	`sub(float v1, float v2)` 提供精确的减法运算
`static BigDecimal`	`sub(Number... values)` 提供精确的减法运算如果传入多个值为null或者空,则返回0
`static BigDecimal`	`sub(Number v1, Number v2)` 提供精确的减法运算如果传入多个值为null或者空,则返回0
`static BigDecimal`	`sub(String... values)` 提供精确的减法运算如果传入多个值为null或者空,则返回0
`static BigDecimal`	`toBigDecimal(Number number)` 数字转`BigDecimal`
`static BigDecimal`	`toBigDecimal(String number)` 数字转`BigDecimal`
`static String`	`toStr(Number number)` 数字转字符串调用`Object.toString()`,并去除尾小数点儿后多余的0
`static String`	`toStr(Number number, String defaultValue)` 数字转字符串调用`Object.toString()`,并去除尾小数点儿后多余的0
`static int`	`zero2One(int value)` 如果给定值为0,返回1,否则返回原值

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - NumberUtils
```
public NumberUtils()
```
- Method Detail
  - add
```
public static double add(float v1,
                         float v2)
```
    提供精确的加法运算
    
    Parameters:
    
    v1 - 被加数
    
    v2 - 加数
    
    Returns:
    
    和
  - add
```
public static double add(float v1,
                         double v2)
```
    提供精确的加法运算
    
    Parameters:
    
    v1 - 被加数
    
    v2 - 加数
    
    Returns:
    
    和
  - add
```
public static double add(double v1,
                         float v2)
```
    提供精确的加法运算
    
    Parameters:
    
    v1 - 被加数
    
    v2 - 加数
    
    Returns:
    
    和
  - add
```
public static double add(double v1,
                         double v2)
```
    提供精确的加法运算
    
    Parameters:
    
    v1 - 被加数
    
    v2 - 加数
    
    Returns:
    
    和
  - add
```
public static BigDecimal add(Number v1,
                             Number v2)
```
    提供精确的加法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    v1 - 被加数
    
    v2 - 加数
    
    Returns:
    
    和
  - add
```
public static BigDecimal add(Number... values)
```
    提供精确的加法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被加值
    
    Returns:
    
    和
  - add
```
public static BigDecimal add(String... values)
```
    提供精确的加法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被加值
    
    Returns:
    
    和
  - add
```
public static BigDecimal add(BigDecimal... values)
```
    提供精确的加法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被加值
    
    Returns:
    
    和
  - sub
```
public static double sub(float v1,
                         float v2)
```
    提供精确的减法运算
    
    Parameters:
    
    v1 - 被减数
    
    v2 - 减数
    
    Returns:
    
    差
  - sub
```
public static double sub(float v1,
                         double v2)
```
    提供精确的减法运算
    
    Parameters:
    
    v1 - 被减数
    
    v2 - 减数
    
    Returns:
    
    差
  - sub
```
public static double sub(double v1,
                         float v2)
```
    提供精确的减法运算
    
    Parameters:
    
    v1 - 被减数
    
    v2 - 减数
    
    Returns:
    
    差
  - sub
```
public static double sub(double v1,
                         double v2)
```
    提供精确的减法运算
    
    Parameters:
    
    v1 - 被减数
    
    v2 - 减数
    
    Returns:
    
    差
  - sub
```
public static BigDecimal sub(Number v1,
                             Number v2)
```
    提供精确的减法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    v1 - 被减数
    
    v2 - 减数
    
    Returns:
    
    差
  - sub
```
public static BigDecimal sub(Number... values)
```
    提供精确的减法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被减值
    
    Returns:
    
    差
  - sub
```
public static BigDecimal sub(String... values)
```
    提供精确的减法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被减值
    
    Returns:
    
    差
  - sub
```
public static BigDecimal sub(BigDecimal... values)
```
    提供精确的减法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被减值
    
    Returns:
    
    差
  - mul
```
public static double mul(float v1,
                         float v2)
```
    提供精确的乘法运算
    
    Parameters:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    Returns:
    
    积
  - mul
```
public static double mul(float v1,
                         double v2)
```
    提供精确的乘法运算
    
    Parameters:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    Returns:
    
    积
  - mul
```
public static double mul(double v1,
                         float v2)
```
    提供精确的乘法运算
    
    Parameters:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    Returns:
    
    积
  - mul
```
public static double mul(double v1,
                         double v2)
```
    提供精确的乘法运算
    
    Parameters:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    Returns:
    
    积
  - mul
```
public static BigDecimal mul(Number v1,
                             Number v2)
```
    提供精确的乘法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    Returns:
    
    积
  - mul
```
public static BigDecimal mul(Number... values)
```
    提供精确的乘法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被乘值
    
    Returns:
    
    积
  - mul
```
public static BigDecimal mul(String v1,
                             String v2)
```
    提供精确的乘法运算
    
    Parameters:
    
    v1 - 被乘数
    
    v2 - 乘数
    
    Returns:
    
    积
  - mul
```
public static BigDecimal mul(String... values)
```
    提供精确的乘法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被乘值
    
    Returns:
    
    积
  - mul
```
public static BigDecimal mul(BigDecimal... values)
```
    提供精确的乘法运算如果传入多个值为null或者空,则返回0
    
    Parameters:
    
    values - 多个被乘值
    
    Returns:
    
    积
  - div
```
public static double div(float v1,
                         float v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         double v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         float v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         double v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    Returns:
    
    两个参数的商
  - div
```
public static BigDecimal div(Number v1,
                             Number v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    Returns:
    
    两个参数的商
    
    Since:
    
    3.1.9
  - div
```
public static BigDecimal div(String v1,
                             String v2)
```
    提供(相对)精确的除法运算,当发生除不尽的情况的时候,精确到小数点后10位,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         float v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         double v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         float v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         double v2,
                         int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    Returns:
    
    两个参数的商
  - div
```
public static BigDecimal div(Number v1,
                             Number v2,
                             int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    Returns:
    
    两个参数的商
    
    Since:
    
    3.1.9
  - div
```
public static BigDecimal div(String v1,
                             String v2,
                             int scale)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度,后面的四舍五入
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         float v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(float v1,
                         double v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         float v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    两个参数的商
  - div
```
public static double div(double v1,
                         double v2,
                         int scale,
                         RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    两个参数的商
  - div
```
public static BigDecimal div(Number v1,
                             Number v2,
                             int scale,
                             RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    两个参数的商
    
    Since:
    
    3.1.9
  - div
```
public static BigDecimal div(String v1,
                             String v2,
                             int scale,
                             RoundingMode roundingMode)
```
    提供(相对)精确的除法运算,当发生除不尽的情况时,由scale指定精确度
    
    Parameters:
    
    v1 - 被除数
    
    v2 - 除数
    
    scale - 精确度,如果为负值,取绝对值
    
    roundingMode - 保留小数的模式 RoundingMode
    
    Returns:
    
    两个参数的商
  - round
```
public static BigDecimal round(BigDecimal number,
                               int scale)
```
    保留固定位数小数采用四舍五入策略 RoundingMode.HALF_UP 例如保留2位小数：123.456789 =》 123.46
    
    Parameters:
    
    number - 数字值
    
    scale - 保留小数位数
    
    Returns:
    
    新值
  - round
```
public static BigDecimal round(BigDecimal number,
                               int scale,
                               RoundingMode roundingMode)
```
    保留固定位数小数例如保留四位小数：123.456789 =》 123.4567
    
    Parameters:
    
    number - 数字值
    
    scale - 保留小数位数,如果传入小于0,则默认0
    
    roundingMode - 保留小数的模式 RoundingMode,如果传入null则默认四舍五入
    
    Returns:
    
    新值
  - roundHalfEven
```
public static BigDecimal roundHalfEven(Number number,
                                       int scale)
```
    四舍六入五成双计算法
    四舍六入五成双是一种比较精确比较科学的计数保留法,是一种数字修约规则
```
 算法规则:
 四舍六入五考虑,
 五后非零就进一,
 五后皆零看奇偶,
 五前为偶应舍去,
 五前为奇要进一
 
```
    Parameters:
    
    number - 需要科学计算的数据
    
    scale - 保留的小数位
    
    Returns:
    
    结果
  - roundHalfEven
```
public static BigDecimal roundHalfEven(BigDecimal value,
                                       int scale)
```
    四舍六入五成双计算法
    四舍六入五成双是一种比较精确比较科学的计数保留法,是一种数字修约规则
```
 算法规则:
 四舍六入五考虑,
 五后非零就进一,
 五后皆零看奇偶,
 五前为偶应舍去,
 五前为奇要进一
 
```
    Parameters:
    
    value - 需要科学计算的数据
    
    scale - 保留的小数位
    
    Returns:
    
    结果
  - roundDown
```
public static BigDecimal roundDown(Number number,
                                   int scale)
```
    保留固定小数位数,舍去多余位数
    
    Parameters:
    
    number - 需要科学计算的数据
    
    scale - 保留的小数位
    
    Returns:
    
    结果
  - roundDown
```
public static BigDecimal roundDown(BigDecimal value,
                                   int scale)
```
    保留固定小数位数,舍去多余位数
    
    Parameters:
    
    value - 需要科学计算的数据
    
    scale - 保留的小数位
    
    Returns:
    
    结果
  - decimalFormat
```
public static String decimalFormat(String pattern,
                                   double value)
```
    格式化double 对 DecimalFormat 做封装
    Parameters:
    pattern - 格式格式中主要以 # 和 0 两种占位符号来指定数字长度 0 表示如果位数不足则以 0 填充,# 表示只要有可能就把数字拉上这个位置
    
    0 =》取一位整数
    
    0.00 =》取一位整数和两位小数
    
    00.000 =》取两位整数和三位小数
    
    # =》取所有整数部分
    
    #.##% =》以百分比方式计数,并取两位小数
    
    #.#####E0 =》显示为科学计数法,并取五位小数
    
    ,### =》每三位以逗号进行分隔,例如：299,792,458
    
    光速大小为每秒,###米 =》将格式嵌入文本
    value - 值
    
    Returns:
    
    格式化后的值
  - decimalFormat
```
public static String decimalFormat(String pattern,
                                   long value)
```
    格式化double 对 DecimalFormat 做封装
    Parameters:
    pattern - 格式格式中主要以 # 和 0 两种占位符号来指定数字长度 0 表示如果位数不足则以 0 填充,# 表示只要有可能就把数字拉上这个位置
    
    0 =》取一位整数
    
    0.00 =》取一位整数和两位小数
    
    00.000 =》取两位整数和三位小数
    
    # =》取所有整数部分
    
    #.##% =》以百分比方式计数,并取两位小数
    
    #.#####E0 =》显示为科学计数法,并取五位小数
    
    ,### =》每三位以逗号进行分隔,例如：299,792,458
    
    光速大小为每秒,###米 =》将格式嵌入文本
    value - 值
    
    Returns:
    
    格式化后的值
    
    Since:
    
    3.1.9
  - decimalFormatMoney
```
public static String decimalFormatMoney(double value)
```
    格式化金额输出,每三位用逗号分隔
    
    Parameters:
    
    value - 金额
    
    Returns:
    
    格式化后的值
    
    Since:
    
    3.1.9
  - formatPercent
```
public static String formatPercent(double number,
                                   int scale)
```
    格式化百分比,小数采用四舍五入方式
    
    Parameters:
    
    number - 值
    
    scale - 保留小数位数
    
    Returns:
    
    百分比
    
    Since:
    
    3.2.3
  - isNumber
```
public static boolean isNumber(String str)
```
    是否为数字
    
    Parameters:
    
    str - 字符串值
    
    Returns:
    
    是否为数字
  - isInteger
```
public static boolean isInteger(String s)
```
    判断String是否是整数
    
    Parameters:
    
    s - String
    
    Returns:
    
    是否为整数
  - isLong
```
public static boolean isLong(String s)
```
    判断字符串是否是Long类型
    
    Parameters:
    
    s - String
    
    Returns:
    
    是否为Long类型
  - isDouble
```
public static boolean isDouble(String s)
```
    判断字符串是否是浮点数
    
    Parameters:
    
    s - String
    
    Returns:
    
    是否为Double类型
  - isPrimes
```
public static boolean isPrimes(int n)
```
    是否是质数质数表的质数又称素数指整数在一个大于1的自然数中,除了1和此整数自身外,没法被其他自然数整除的数
    
    Parameters:
    
    n - 数字
    
    Returns:
    
    是否是质数
  - generateRandomNumber
```
public static int[] generateRandomNumber(int begin,
                                         int end,
                                         int size)
```
    生成不重复随机数根据给定的最小数字和最大数字,以及随机数的个数,产生指定的不重复的数组
    
    Parameters:
    
    begin - 最小数字（包含该数）
    
    end - 最大数字（不包含该数）
    
    size - 指定产生随机数的个数
    
    Returns:
    
    随机int数组
  - generateBySet
```
public static Integer[] generateBySet(int begin,
                                      int end,
                                      int size)
```
    生成不重复随机数根据给定的最小数字和最大数字,以及随机数的个数,产生指定的不重复的数组
    
    Parameters:
    
    begin - 最小数字（包含该数）
    
    end - 最大数字（不包含该数）
    
    size - 指定产生随机数的个数
    
    Returns:
    
    随机int数组
  - range
```
public static int[] range(int stop)
```
    从0开始给定范围内的整数列表,步进为1
    
    Parameters:
    
    stop - 结束（包含）
    
    Returns:
    
    整数列表
    
    Since:
    
    3.3.1
  - range
```
public static int[] range(int start,
                          int stop)
```
    给定范围内的整数列表,步进为1
    
    Parameters:
    
    start - 开始（包含）
    
    stop - 结束（包含）
    
    Returns:
    
    整数列表
  - range
```
public static int[] range(int start,
                          int stop,
                          int step)
```
    给定范围内的整数列表
    
    Parameters:
    
    start - 开始（包含）
    
    stop - 结束（包含）
    
    step - 步进
    
    Returns:
    
    整数列表
  - appendRange
```
public static Collection<Integer> appendRange(int start,
                                              int stop,
                                              Collection<Integer> values)
```
    将给定范围内的整数添加到已有集合中,步进为1
    
    Parameters:
    
    start - 开始（包含）
    
    stop - 结束（包含）
    
    values - 集合
    
    Returns:
    
    集合
  - appendRange
```
public static Collection<Integer> appendRange(int start,
                                              int stop,
                                              int step,
                                              Collection<Integer> values)
```
    将给定范围内的整数添加到已有集合中
    
    Parameters:
    
    start - 开始（包含）
    
    stop - 结束（包含）
    
    step - 步进
    
    values - 集合
    
    Returns:
    
    集合
  - factorial
```
public static long factorial(long start,
                             long end)
```
    计算阶乘
    n! = n * (n-1) * ... * end
    
    Parameters:
    
    start - 阶乘起始
    
    end - 阶乘结束
    
    Returns:
    
    结果
  - factorial
```
public static long factorial(long n)
```
    计算阶乘
    n! = n * (n-1) * ... * 2 * 1
    
    Parameters:
    
    n - 阶乘起始
    
    Returns:
    
    结果
  - sqrt
```
public static long sqrt(long x)
```
    平方根算法推荐使用 Math.sqrt(double)
    
    Parameters:
    
    x - 值
    
    Returns:
    
    平方根
  - processMultiple
```
public static int processMultiple(int selectNum,
                                  int minNum)
```
    可以用于计算双色球、大乐透注数的方法比如大乐透35选5可以这样调用processMultiple(7,5); 就是数学中的：C75=7*6/2*1
    
    Parameters:
    
    selectNum - 选中小球个数
    
    minNum - 最少要选中多少个小球
    
    Returns:
    
    注数
  - divisor
```
public static int divisor(int m,
                          int n)
```
    最大公约数
    
    Parameters:
    
    m - 第一个值
    
    n - 第二个值
    
    Returns:
    
    最大公约数
  - multiple
```
public static int multiple(int m,
                           int n)
```
    最小公倍数
    
    Parameters:
    
    m - 第一个值
    
    n - 第二个值
    
    Returns:
    
    最小公倍数
  - getBinaryStr
```
public static String getBinaryStr(Number number)
```
    获得数字对应的二进制字符串
    
    Parameters:
    
    number - 数字
    
    Returns:
    
    二进制字符串
  - binaryToInt
```
public static int binaryToInt(String binaryStr)
```
    二进制转int
    
    Parameters:
    
    binaryStr - 二进制字符串
    
    Returns:
    
    int
  - binaryToLong
```
public static long binaryToLong(String binaryStr)
```
    二进制转long
    
    Parameters:
    
    binaryStr - 二进制字符串
    
    Returns:
    
    long
  - compare
```
public static int compare(char x,
                          char y)
```
    比较两个值的大小
    
    Parameters:
    
    x - 第一个值
    
    y - 第二个值
    
    Returns:
    
    x==y返回0,x<y返回-1,x>y返回1
    
    Since:
    
    3.0.1
    
    See Also:
    
    Character.compare(char, char)
  - compare
```
public static int compare(double x,
                          double y)
```
    比较两个值的大小
    
    Parameters:
    
    x - 第一个值
    
    y - 第二个值
    
    Returns:
    
    x==y返回0,x<y返回-1,x>y返回1
    
    Since:
    
    3.0.1
    
    See Also:
    
    Double.compare(double, double)
  - compare
```
public static int compare(int x,
                          int y)
```
    比较两个值的大小
    
    Parameters:
    
    x - 第一个值
    
    y - 第二个值
    
    Returns:
    
    x==y返回0,x<y返回-1,x>y返回1
    
    Since:
    
    3.0.1
    
    See Also:
    
    Integer.compare(int, int)
  - compare
```
public static int compare(long x,
                          long y)
```
    比较两个值的大小
    
    Parameters:
    
    x - 第一个值
    
    y - 第二个值
    
    Returns:
    
    x==y返回0,x<y返回-1,x>y返回1
    
    Since:
    
    3.0.1
    
    See Also:
    
    Long.compare(long, long)
  - compare
```
public static int compare(short x,
                          short y)
```
    比较两个值的大小
    
    Parameters:
    
    x - 第一个值
    
    y - 第二个值
    
    Returns:
    
    x==y返回0,x<y返回-1,x>y返回1
    
    Since:
    
    3.0.1
    
    See Also:
    
    Short.compare(short, short)
  - compare
```
public static int compare(byte x,
                          byte y)
```
    比较两个值的大小
    
    Parameters:
    
    x - 第一个值
    
    y - 第二个值
    
    Returns:
    
    x==y返回0,x<y返回-1,x>y返回1
    
    Since:
    
    3.0.1
    
    See Also:
    
    Byte.compare(byte, byte)
  - equals
```
public static boolean equals(char c1,
                             char c2,
                             boolean ignoreCase)
```
    比较两个字符是否相同
    
    Parameters:
    
    c1 - 字符1
    
    c2 - 字符2
    
    ignoreCase - 是否忽略大小写
    
    Returns:
    
    是否相同
    
    Since:
    
    5.2.8
    
    See Also:
    
    CharUtils.equals(char, char, boolean)
  - min
```
public static <T extends Comparable<? super T>> T min(T... numberArray)
```
    取最小值
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
    
    See Also:
    
    ArrayUtils.min(Comparable[])
  - min
```
public static long min(long... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
    
    See Also:
    
    ArrayUtils.min(long...)
  - min
```
public static int min(int... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
    
    See Also:
    
    ArrayUtils.min(int...)
  - min
```
public static short min(short... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
    
    See Also:
    
    ArrayUtils.min(short...)
  - min
```
public static double min(double... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
    
    See Also:
    
    ArrayUtils.min(double...)
  - min
```
public static float min(float... numberArray)
```
    取最小值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最小值
    
    See Also:
    
    ArrayUtils.min(float...)
  - max
```
public static <T extends Comparable<? super T>> T max(T... numberArray)
```
    取最大值
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
    
    See Also:
    
    ArrayUtils.max(Comparable[])
  - max
```
public static long max(long... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
    
    See Also:
    
    ArrayUtils.max(long...)
  - max
```
public static int max(int... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
    
    See Also:
    
    ArrayUtils.max(int...)
  - max
```
public static short max(short... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
    
    See Also:
    
    ArrayUtils.max(short...)
  - max
```
public static double max(double... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
    
    See Also:
    
    ArrayUtils.max(double...)
  - max
```
public static float max(float... numberArray)
```
    取最大值
    
    Parameters:
    
    numberArray - 数字数组
    
    Returns:
    
    最大值
    
    See Also:
    
    ArrayUtils.max(float...)
  - toStr
```
public static String toStr(Number number,
                           String defaultValue)
```
    数字转字符串调用Object.toString(),并去除尾小数点儿后多余的0
    
    Parameters:
    
    number - A Number
    
    defaultValue - 如果number参数为null,返回此默认值
    
    Returns:
    
    A String.
    
    Since:
    
    3.1.9
  - toStr
```
public static String toStr(Number number)
```
    数字转字符串调用Object.toString(),并去除尾小数点儿后多余的0
    
    Parameters:
    
    number - A Number
    
    Returns:
    
    A String.
  - toBigDecimal
```
public static BigDecimal toBigDecimal(Number number)
```
    数字转BigDecimal
    
    Parameters:
    
    number - 数字
    
    Returns:
    
    BigDecimal
  - toBigDecimal
```
public static BigDecimal toBigDecimal(String number)
```
    数字转BigDecimal
    
    Parameters:
    
    number - 数字
    
    Returns:
    
    BigDecimal
  - count
```
public static int count(int total,
                        int part)
```
    计算等份个数
    
    Parameters:
    
    total - 总数
    
    part - 每份的个数
    
    Returns:
    
    分成了几份
    
    Since:
    
    3.1.9
  - null2Zero
```
public static BigDecimal null2Zero(BigDecimal decimal)
```
    空转0
    
    Parameters:
    
    decimal - BigDecimal,可以为null
    
    Returns:
    
    BigDecimal参数为空时返回0的值
    
    Since:
    
    3.1.9
  - zero2One
```
public static int zero2One(int value)
```
    如果给定值为0,返回1,否则返回原值
    
    Parameters:
    
    value - 值
    
    Returns:
    
    1或非0值
    
    Since:
    
    3.1.9
  - newBigInteger
```
public static BigInteger newBigInteger(String str)
```
    创建BigInteger,支持16进制、10进制和8进制,如果传入空白串返回null from Apache Common Lang
    
    Parameters:
    
    str - 数字字符串
    
    Returns:
    
    BigInteger
    
    Since:
    
    5.2.8
  - isBeside
```
public static boolean isBeside(long number1,
                               long number2)
```
    判断两个数字是否相邻,例如1和2相邻,1和3不相邻判断方法为做差取绝对值判断是否为1
    
    Parameters:
    
    number1 - 数字1
    
    number2 - 数字2
    
    Returns:
    
    是否相邻
  - isBeside
```
public static boolean isBeside(int number1,
                               int number2)
```
    判断两个数字是否相邻,例如1和2相邻,1和3不相邻判断方法为做差取绝对值判断是否为1
    
    Parameters:
    
    number1 - 数字1
    
    number2 - 数字2
    
    Returns:
    
    是否相邻
  - partValue
```
public static int partValue(int total,
                            int partCount)
```
    把给定的总数平均分成N份,返回每份的个数当除以分数有余数时每份+1
    
    Parameters:
    
    total - 总数
    
    partCount - 份数
    
    Returns:
    
    每份的个数
  - partValue
```
public static int partValue(int total,
                            int partCount,
                            boolean isPlusOneWhenHasRem)
```
    把给定的总数平均分成N份,返回每份的个数如果isPlusOneWhenHasRem为true,则当除以分数有余数时每份+1,否则丢弃余数部分
    
    Parameters:
    
    total - 总数
    
    partCount - 份数
    
    isPlusOneWhenHasRem - 在有余数时是否每份+1
    
    Returns:
    
    每份的个数
  - pow
```
public static BigDecimal pow(Number number,
                             int n)
```
    提供精确的幂运算
    
    Parameters:
    
    number - 底数
    
    n - 指数
    
    Returns:
    
    幂的积
  - pow
```
public static BigDecimal pow(BigDecimal number,
                             int n)
```
    提供精确的幂运算
    
    Parameters:
    
    number - 底数
    
    n - 指数
    
    Returns:
    
    幂的积
  - parseInt
```
public static int parseInt(String number)
```
    解析转换数字字符串为int型数字,规则如下：
```
 1、0x开头的视为16进制数字
 2、0开头的视为8进制数字
 3、空串返回0
 4、其它情况按照10进制转换
 
```
    Parameters:
    
    number - 数字,支持0x开头、0开头和普通十进制
    
    Returns:
    
    int
  - parseLong
```
public static long parseLong(String number)
```
    解析转换数字字符串为long型数字,规则如下：
```
 1、0x开头的视为16进制数字
 2、0开头的视为8进制数字
 3、空串返回0
 4、其它情况按照10进制转换
 
```
    Parameters:
    
    number - 数字,支持0x开头、0开头和普通十进制
    
    Returns:
    
    long
  - parseNumber
```
public static Number parseNumber(String numberStr)
```
    将指定字符串转换为Number 对象
    
    Parameters:
    
    numberStr - Number字符串
    
    Returns:
    
    Number对象
  - addZero
```
public static String addZero(Number numObj,
                             int length)
```
    给数字对象按照指定长度在左侧补0.
    使用案例: addZero2Str(11,4) 返回 "0011", addZero2Str(-18,6)返回 "-000018"
    
    Parameters:
    
    numObj - 数字对象
    
    length - 指定的长度
    
    Returns:
    
    the string

Class NumberUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

NumberUtils

Method Detail

add

add

add

add

add

add

add

add

sub

sub

sub

sub

sub

sub

sub

sub

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

round

round

roundHalfEven

roundHalfEven

roundDown

roundDown

decimalFormat

decimalFormat

decimalFormatMoney

formatPercent

isNumber

isInteger

isLong

isDouble

isPrimes

generateRandomNumber

generateBySet

range

range

range

appendRange

appendRange

factorial

factorial

sqrt

processMultiple

divisor

multiple

getBinaryStr

binaryToInt