BigDecimalUtil (mirana hero template 2.0.0 API)

java.lang.Object
- pro.fessional.mirana.math.BigDecimalUtil

```
public class BigDecimalUtil
extends Object
```
null友好的BigDecimal工具类

Since:

2015-12-11.

Author:

trydofor

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class BigDecimalUtil.W
null当零处理，非线程安全

Nested Classes
Modifier and Type	Class and Description
`static class`	`BigDecimalUtil.W` null当零处理，非线程安全

Constructor Summary

Constructors
Constructor and Description

BigDecimalUtil()

Constructors
Constructor and Description
`BigDecimalUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static @NotNull BigDecimal`	`add(BigDecimal a, BigDecimal b)`
`static @NotNull BigDecimal`	`add(BigDecimal a, BigDecimal b, BigDecimal c)` 加法，R=A+(B==null?C:B)，null = Zero ① null + null + null = Zero ② null + null + C = C ③ null + B + null = B ④ null + B + C = B ⑤ A + null + null = A ⑥ A + null + C = A + C ⑦ A + B + null = A + B ⑧ A + B + C = A + B
`static @NotNull BigDecimal`	`add(BigDecimal a, double b)`
`static @NotNull BigDecimal`	`add(BigDecimal a, int b)`
`static @NotNull BigDecimal`	`add(BigDecimal a, long b)`
`static @NotNull BigDecimal`	`add(BigDecimal a, Number b)`
`static @NotNull BigDecimal`	`add(BigDecimal a, Number b, BigDecimal c)`
`static @NotNull BigDecimal`	`add(BigDecimal a, String b)`
`static @NotNull BigDecimal`	`add(BigDecimal a, String b, BigDecimal c)`
`static @NotNull BigDecimal`	`avg(BigDecimal... vs)` 平均数，null当做零处理
`static @NotNull BigDecimal`	`avg(boolean skipNull, BigDecimal... vs)` 平均数，null当做零处理或忽略
`static @NotNull BigDecimal`	`avg(boolean skipNull, Number... vs)`
`static @NotNull BigDecimal`	`avg(boolean skipNull, String... vs)`
`static @NotNull BigDecimal`	`avg(Number... vs)`
`static @NotNull BigDecimal`	`avg(String... vs)`
`static @NotNull BigDecimal`	`ceil(BigDecimal value, int scale)` 向上取整
`static @NotNull BigDecimal`	`ceil(Number value, int scale)`
`static @NotNull BigDecimal`	`ceil(String value, int scale)`
`static int`	`compareTo(BigDecimal a, BigDecimal b)` null小于一切
`static int`	`compareTo(BigDecimal a, BigDecimal b, int scale, RoundingMode mode)` null小于一切
`static int`	`compareTo(BigDecimal a, double b)` null小于一切
`static int`	`compareTo(BigDecimal a, Number b)`
`static int`	`compareTo(BigDecimal a, Number b, int scale, RoundingMode mode)`
`static int`	`compareTo(BigDecimal a, String b)`
`static int`	`compareTo(BigDecimal a, String b, int scale, RoundingMode mode)`
`static @NotNull BigDecimal`	`div(BigDecimal a, BigDecimal b)`
`static @NotNull BigDecimal`	`div(BigDecimal a, BigDecimal b, BigDecimal c)` 除法，R=A/(B==null?C:B)，null = Zero, Error ① null / null / null = ERROR ② null / null / C = Zero ③ null / B / null = Zero ④ null / B / C = Zero ⑤ A / null / null = ERROR ⑥ A / null / C = A / C ⑦ A / B / null = A / B ⑧ A / B / C = A / B
`static @NotNull BigDecimal`	`div(BigDecimal a, double b)`
`static @NotNull BigDecimal`	`div(BigDecimal a, int b)`
`static @NotNull BigDecimal`	`div(BigDecimal a, long b)`
`static @NotNull BigDecimal`	`div(BigDecimal a, Number b)`
`static @NotNull BigDecimal`	`div(BigDecimal a, Number b, BigDecimal c)`
`static @NotNull BigDecimal`	`div(BigDecimal a, String b)`
`static @NotNull BigDecimal`	`div(BigDecimal a, String b, BigDecimal c)`
`static boolean`	`equalsValue(BigDecimal a, BigDecimal b)` null == null, null != notnull
`static boolean`	`equalsValue(BigDecimal a, BigDecimal b, int scale, RoundingMode mode)` null == null, null != notnull
`static boolean`	`equalsValue(BigDecimal a, Number b)`
`static boolean`	`equalsValue(BigDecimal a, Number b, int scale, RoundingMode mode)`
`static boolean`	`equalsValue(BigDecimal a, String b)`
`static boolean`	`equalsValue(BigDecimal a, String b, int scale, RoundingMode mode)`
`static @NotNull BigDecimal`	`floor(BigDecimal value, int scale)` 向下取整
`static @NotNull BigDecimal`	`floor(Number value, int scale)`
`static @NotNull BigDecimal`	`floor(String value, int scale)`
`static BigDecimal`	`max(BigDecimal a, BigDecimal b)` 求最大值，null忽略
`static BigDecimal`	`max(BigDecimal a, Number b)` 求最大值，null忽略
`static BigDecimal`	`max(BigDecimal a, String b)` 求最大值，null忽略
`static BigDecimal`	`min(BigDecimal a, BigDecimal b)` 最小值，null忽略
`static BigDecimal`	`min(BigDecimal a, Number b)` 最小值，null忽略
`static BigDecimal`	`min(BigDecimal a, String b)` 最小值，null忽略
`static @NotNull BigDecimal`	`mul(BigDecimal a, BigDecimal b)`
`static @NotNull BigDecimal`	`mul(BigDecimal a, BigDecimal b, BigDecimal c)` 乘法，R=Ax(B==null?C:B)，null = Zero ① null x null x null = Zero ② null x null x C = Zero ③ null x B x null = Zero ④ null x B x C = Zero ⑤ A x null x null = Zero ⑥ A x null x C = A x C ⑦ A x B x null = A x B ⑧ A x B x C = A x B
`static @NotNull BigDecimal`	`mul(BigDecimal a, double b)`
`static @NotNull BigDecimal`	`mul(BigDecimal a, int b)`
`static @NotNull BigDecimal`	`mul(BigDecimal a, long b)`
`static @NotNull BigDecimal`	`mul(BigDecimal a, Number b)`
`static @NotNull BigDecimal`	`mul(BigDecimal a, Number b, BigDecimal c)`
`static @NotNull BigDecimal`	`mul(BigDecimal a, String b)`
`static @NotNull BigDecimal`	`mul(BigDecimal a, String b, BigDecimal c)`
`static @NotNull BigDecimal`	`neg(BigDecimal a)` 负数，null当零处理
`static @NotNull BigDecimal`	`neg(Number a)`
`static @NotNull BigDecimal`	`neg(String a)`
`static @NotNull BigDecimal`	`notNull(@NotNull BigDecimal elz, BigDecimal... vs)`
`static @NotNull BigDecimal`	`notNull(@NotNull BigDecimal elz, Number... vs)`
`static @NotNull BigDecimal`	`notNull(@NotNull BigDecimal elz, String... vs)`
`static BigDecimal`	`object(Number num)`
`static BigDecimal`	`object(Number num, BigDecimal elz)`
`static BigDecimal`	`object(String str)` 从字符串构造
`static BigDecimal`	`object(String str, BigDecimal elz)` 从字符串构造
`static BigDecimal[]`	`objects(BigDecimal elz, Number... vs)` 从字符串构造
`static BigDecimal[]`	`objects(BigDecimal elz, String... vs)` 从字符串构造
`static @NotNull BigDecimal`	`pow(BigDecimal a, int n)` 乘方，null当零处理
`static @NotNull BigDecimal`	`pow(Number a, int n)`
`static @NotNull BigDecimal`	`pow(String a, int n)`
`static @NotNull BigDecimal`	`prd(boolean skipNull, BigDecimal... vs)` 联乘，忽略null或当零处理
`static @NotNull BigDecimal`	`prd(boolean skipNull, Number... vs)` 联乘，忽略null或当零处理
`static @NotNull BigDecimal`	`prd(boolean skipNull, String... vs)` 联乘，忽略null或当零处理
`static @NotNull BigDecimal`	`round(BigDecimal value, int scale)` 四舍五入
`static @NotNull BigDecimal`	`round(Number value, int scale)`
`static @NotNull BigDecimal`	`round(String value, int scale)`
`static @NotNull BigDecimal`	`scale(BigDecimal value, int scale, RoundingMode mode)` 砍掉`scale+1`位之后的所有数字，对`scale+1`位进行进位操作。
`static @NotNull BigDecimal`	`scale(Number value, int scale, RoundingMode mode)`
`static @NotNull BigDecimal`	`scale(String value, int scale, RoundingMode mode)`
`static @NotNull String`	`string(BigDecimal v)` null时返回空
`static @NotNull String`	`string(BigDecimal v, int scale)` 舍去scale+1位后，向上取值
`static String`	`string(BigDecimal v, String elz)` 字符串化
`static @NotNull BigDecimal`	`sub(BigDecimal a, BigDecimal b)`
`static @NotNull BigDecimal`	`sub(BigDecimal a, BigDecimal b, BigDecimal c)` 减法，R=A-(B==null?C:B)，null = Zero ① null - null - null = Zero ② null - null - C = -C ③ null - B - null = -B ④ null - B - C = -B ⑤ A - null - null = A ⑥ A - null - C = A - C ⑦ A - B - null = A - B ⑧ A - B - C = A - B
`static @NotNull BigDecimal`	`sub(BigDecimal a, double b)`
`static @NotNull BigDecimal`	`sub(BigDecimal a, int b)`
`static @NotNull BigDecimal`	`sub(BigDecimal a, long b)`
`static @NotNull BigDecimal`	`sub(BigDecimal a, Number b)`
`static @NotNull BigDecimal`	`sub(BigDecimal a, Number b, BigDecimal c)`
`static @NotNull BigDecimal`	`sub(BigDecimal a, String b)`
`static @NotNull BigDecimal`	`sub(BigDecimal a, String b, BigDecimal c)`
`static @NotNull BigDecimal`	`sum(BigDecimal... vs)` 求和
`static @NotNull BigDecimal`	`sum(Number... vs)`
`static @NotNull BigDecimal`	`sum(String... vs)`
`static @NotNull BigDecimal`	`unitDown(BigDecimal value, BigDecimal unit)`
`static @NotNull BigDecimal`	`unitDown(BigDecimal value, BigDecimal unit, BigDecimal upto)` 以单位向下取整, null 当零处理, scale以unit为准。以称重计价为例，称的精度0.01，每0.5计价当x >= 0.4时，按0.5处理，否则按0处理当x >= 0.9时，按1处理，否则按0.5处理
`static @NotNull BigDecimal`	`unitUp(BigDecimal value, BigDecimal unit)`
`static @NotNull BigDecimal`	`unitUp(BigDecimal value, BigDecimal unit, BigDecimal down)` 以单位向上取整, null 当零处理, scale以unit为准。以称重计价为例，称的精度0.01，每0.5计价当x > 0.1时，按0.5处理，否则按0处理当x > 0.6时，按1处理，否则按0.5处理
`static @NotNull BigDecimalUtil.W`	`w(BigDecimal... vs)`
`static @NotNull BigDecimalUtil.W`	`w(BigDecimal v)`
`static @NotNull BigDecimalUtil.W`	`w(BigDecimal v, int scale)`
`static @NotNull BigDecimalUtil.W`	`w(int scale, BigDecimal... vs)`
`static @NotNull BigDecimalUtil.W`	`w(int scale, Number... vs)`
`static @NotNull BigDecimalUtil.W`	`w(Number v)`
`static @NotNull BigDecimalUtil.W`	`w(Number v, int scale)`
`static @NotNull BigDecimalUtil.W`	`w(Number v, int scale, @NotNull BigDecimal el)`
`static @NotNull BigDecimalUtil.W`	`w(String v)`
`static @NotNull BigDecimalUtil.W`	`w(String v, int scale)`
`static @NotNull BigDecimalUtil.W`	`w(String v, int scale, @NotNull BigDecimal el)`

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

Constructor Detail
- BigDecimalUtil
```
public BigDecimalUtil()
```

Method Detail

string

@NotNull
public static @NotNull String string(BigDecimal v)

null时返回空

Parameters:: v - 数字
Returns:: 字符串

string

@NotNull
public static @NotNull String string(BigDecimal v,
                                              int scale)

舍去scale+1位后，向上取值

Parameters:: v - 数字; scale - 小数点几位
Returns:: 字符串

string

public static String string(BigDecimal v,
                            String elz)

字符串化

Parameters:: v - 数字; elz - null时返回
Returns:: 字符串

object

public static BigDecimal object(Number num)

object
```
public static BigDecimal object(String str)
```
从字符串构造

Parameters:

str - 字符串

Returns:

数字，失败时null

object

public static BigDecimal object(String str,
                                BigDecimal elz)

从字符串构造

Parameters:: str - 字符串; elz - null时返回
Returns:: 数字

object

public static BigDecimal object(Number num,
                                BigDecimal elz)

objects

public static BigDecimal[] objects(BigDecimal elz,
                                   Number... vs)

从字符串构造

Parameters:: vs - 字符串; elz - null时返回
Returns:: 数字

objects

public static BigDecimal[] objects(BigDecimal elz,
                                   String... vs)

从字符串构造

Parameters:: vs - 字符串; elz - null时返回
Returns:: 数字

avg
```
@NotNull
public static @NotNull BigDecimal avg(String... vs)
```
Parameters:

vs - var args

Returns:

平均数

See Also:

avg(BigDecimal...)

avg
```
@NotNull
public static @NotNull BigDecimal avg(Number... vs)
```
Parameters:

vs - var args

Returns:

平均数

See Also:

avg(BigDecimal...)

avg
```
@NotNull
public static @NotNull BigDecimal avg(BigDecimal... vs)
```
平均数，null当做零处理

Parameters:

vs - 数字

Returns:

平均数

avg

@NotNull
public static @NotNull BigDecimal avg(boolean skipNull,
                                               String... vs)

Parameters:: skipNull - 是否忽略null; vs - 数字
Returns:: 平均数
See Also:: avg(boolean, BigDecimal...)

avg

@NotNull
public static @NotNull BigDecimal avg(boolean skipNull,
                                               Number... vs)

Parameters:: skipNull - 是否忽略null; vs - 数字
Returns:: 平均数
See Also:: avg(boolean, BigDecimal...)

avg

@NotNull
public static @NotNull BigDecimal avg(boolean skipNull,
                                               BigDecimal... vs)

平均数，null当做零处理或忽略

Parameters:: skipNull - 是否忽略null; vs - 数字
Returns:: 平均数

sum

@NotNull
public static @NotNull BigDecimal sum(String... vs)

Parameters:: vs - 数字
Returns:: 求和
See Also:: sum(BigDecimal...)

sum

@NotNull
public static @NotNull BigDecimal sum(Number... vs)

Parameters:: vs - 数字
Returns:: 求和
See Also:: sum(BigDecimal...)

sum

@NotNull
public static @NotNull BigDecimal sum(BigDecimal... vs)

求和

Parameters:: vs - 数字
Returns:: 和

prd

@NotNull
public static @NotNull BigDecimal prd(boolean skipNull,
                                               String... vs)

联乘，忽略null或当零处理

Parameters:: skipNull - 忽略null或当零处理; vs - 数字
Returns:: 积
See Also:: prd(boolean, BigDecimal...)

prd

@NotNull
public static @NotNull BigDecimal prd(boolean skipNull,
                                               Number... vs)

联乘，忽略null或当零处理

Parameters:: skipNull - 忽略null或当零处理; vs - 数字
Returns:: 积
See Also:: prd(boolean, BigDecimal...)

prd

@NotNull
public static @NotNull BigDecimal prd(boolean skipNull,
                                               BigDecimal... vs)

联乘，忽略null或当零处理

Parameters:: skipNull - 忽略null或当零处理; vs - 数字
Returns:: 积

notNull

@NotNull
public static @NotNull BigDecimal notNull(@NotNull
                                                   @NotNull BigDecimal elz,
                                                   String... vs)

notNull

@NotNull
public static @NotNull BigDecimal notNull(@NotNull
                                                   @NotNull BigDecimal elz,
                                                   Number... vs)

notNull

@NotNull
public static @NotNull BigDecimal notNull(@NotNull
                                                   @NotNull BigDecimal elz,
                                                   BigDecimal... vs)

max

public static BigDecimal max(BigDecimal a,
                             String b)

求最大值，null忽略

Parameters:: a - 数字; b - 数字
Returns:: 最大值
See Also:: max(BigDecimal, BigDecimal)

max

public static BigDecimal max(BigDecimal a,
                             Number b)

求最大值，null忽略

Parameters:: a - 数字; b - 数字
Returns:: 最大值
See Also:: max(BigDecimal, BigDecimal)

max

public static BigDecimal max(BigDecimal a,
                             BigDecimal b)

求最大值，null忽略

Parameters:: a - 数字; b - 数字
Returns:: 最大值

min

public static BigDecimal min(BigDecimal a,
                             String b)

最小值，null忽略

Parameters:: a - 数字; b - 数字
Returns:: 最小值
See Also:: min(BigDecimal, BigDecimal)

min

public static BigDecimal min(BigDecimal a,
                             Number b)

最小值，null忽略

Parameters:: a - 数字; b - 数字
Returns:: 最小值
See Also:: min(BigDecimal, BigDecimal)

min

public static BigDecimal min(BigDecimal a,
                             BigDecimal b)

最小值，null忽略

Parameters:: a - 数字; b - 数字
Returns:: 最小值

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               int b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               long b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               double b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               Number b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               String b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               BigDecimal b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               String b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               Number b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: add(BigDecimal, BigDecimal, BigDecimal)

add

@NotNull
public static @NotNull BigDecimal add(BigDecimal a,
                                               BigDecimal b,
                                               BigDecimal c)

 加法，R=A+(B==null?C:B)，null = Zero
 ① null + null + null = Zero
 ② null + null + C = C
 ③ null + B + null = B
 ④ null + B + C = B
 ⑤ A + null + null = A
 ⑥ A + null + C = A + C
 ⑦ A + B + null = A + B
 ⑧ A + B + C = A + B

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               int b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               long b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               double b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               String b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               Number b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               BigDecimal b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               String b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               Number b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: sub(BigDecimal, BigDecimal, BigDecimal)

sub

@NotNull
public static @NotNull BigDecimal sub(BigDecimal a,
                                               BigDecimal b,
                                               BigDecimal c)

 减法，R=A-(B==null?C:B)，null = Zero
 ① null - null - null = Zero
 ② null - null - C = -C
 ③ null - B - null = -B
 ④ null - B - C = -B
 ⑤ A - null - null = A
 ⑥ A - null - C = A - C
 ⑦ A - B - null = A - B
 ⑧ A - B - C = A - B

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               int b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               long b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               double b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               String b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               Number b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               BigDecimal b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               String b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               Number b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: mul(BigDecimal, BigDecimal, BigDecimal)

mul

@NotNull
public static @NotNull BigDecimal mul(BigDecimal a,
                                               BigDecimal b,
                                               BigDecimal c)

 乘法，R=Ax(B==null?C:B)，null = Zero
 ① null x null x null = Zero
 ② null x null x C = Zero
 ③ null x B x null = Zero
 ④ null x B x C = Zero
 ⑤ A x null x null = Zero
 ⑥ A x null x C = A x C
 ⑦ A x B x null = A x B
 ⑧ A x B x C = A x B

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               int b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               long b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               double b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               String b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               Number b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               BigDecimal b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               String b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               Number b,
                                               BigDecimal c)

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果
See Also:: div(BigDecimal, BigDecimal, BigDecimal)

div

@NotNull
public static @NotNull BigDecimal div(BigDecimal a,
                                               BigDecimal b,
                                               BigDecimal c)

 除法，R=A/(B==null?C:B)，null = Zero, Error
 ① null / null / null = ERROR
 ② null / null / C = Zero
 ③ null / B / null = Zero
 ④ null / B / C = Zero
 ⑤ A / null / null = ERROR
 ⑥ A / null / C = A / C
 ⑦ A / B / null = A / B
 ⑧ A / B / C = A / B

Parameters:: a - 数字; b - 数字; c - 数字
Returns:: 结果

pow

@NotNull
public static @NotNull BigDecimal pow(String a,
                                               int n)

pow

@NotNull
public static @NotNull BigDecimal pow(Number a,
                                               int n)

pow

@NotNull
public static @NotNull BigDecimal pow(BigDecimal a,
                                               int n)

乘方，null当零处理

Parameters:: a - 数字; n - 数字
Returns:: 结果

neg

@NotNull
public static @NotNull BigDecimal neg(String a)

neg

@NotNull
public static @NotNull BigDecimal neg(Number a)

neg

@NotNull
public static @NotNull BigDecimal neg(BigDecimal a)

负数，null当零处理

Parameters:: a - 数字
Returns:: 结果

ceil

@NotNull
public static @NotNull BigDecimal ceil(String value,
                                                int scale)

ceil

@NotNull
public static @NotNull BigDecimal ceil(Number value,
                                                int scale)

ceil

@NotNull
public static @NotNull BigDecimal ceil(BigDecimal value,
                                                int scale)

向上取整

Parameters:: value - null返回 0.xxx; scale - 小数点位数，如2为0.00
Returns:: 新值

floor

@NotNull
public static @NotNull BigDecimal floor(String value,
                                                 int scale)

floor

@NotNull
public static @NotNull BigDecimal floor(Number value,
                                                 int scale)

floor

@NotNull
public static @NotNull BigDecimal floor(BigDecimal value,
                                                 int scale)

向下取整

Parameters:: value - null返回 0.xxx; scale - 小数点位数，如2为0.00
Returns:: 新值

round

@NotNull
public static @NotNull BigDecimal round(String value,
                                                 int scale)

round

@NotNull
public static @NotNull BigDecimal round(Number value,
                                                 int scale)

round

@NotNull
public static @NotNull BigDecimal round(BigDecimal value,
                                                 int scale)

四舍五入

Parameters:: value - null返回 0.xxx; scale - 小数点位数，如2为0.00
Returns:: 新值

scale

@NotNull
public static @NotNull BigDecimal scale(String value,
                                                 int scale,
                                                 RoundingMode mode)

scale

@NotNull
public static @NotNull BigDecimal scale(Number value,
                                                 int scale,
                                                 RoundingMode mode)

scale

@NotNull
public static @NotNull BigDecimal scale(BigDecimal value,
                                                 int scale,
                                                 RoundingMode mode)

砍掉`scale+1`位之后的所有数字，对`scale+1`位进行进位操作。

Parameters:: value - null返回 0.xxx; scale - 小数点位数，如2为0.00; mode - 舍入类型
Returns:: 新值

unitUp

@NotNull
public static @NotNull BigDecimal unitUp(BigDecimal value,
                                                  BigDecimal unit)

Parameters:: value - 数值; unit - 单位
Returns:: 处理结果
See Also:: unitUp(BigDecimal, BigDecimal, BigDecimal)

unitUp

@NotNull
public static @NotNull BigDecimal unitUp(BigDecimal value,
                                                  BigDecimal unit,
                                                  BigDecimal down)

 以单位向上取整, null 当零处理, scale以unit为准。
 以称重计价为例，称的精度0.01，每0.5计价
 当x > 0.1时，按0.5处理，否则按0处理
 当x > 0.6时，按1处理，否则按0.5处理

Parameters:: value - 数值; unit - 单位; down - 单位后余数，小于等于该值则舍去
Returns:: 处理结果

unitDown

@NotNull
public static @NotNull BigDecimal unitDown(BigDecimal value,
                                                    BigDecimal unit)

Parameters:: value - 数值; unit - 单位
Returns:: 处理结果
See Also:: unitDown(BigDecimal, BigDecimal, BigDecimal)

unitDown

@NotNull
public static @NotNull BigDecimal unitDown(BigDecimal value,
                                                    BigDecimal unit,
                                                    BigDecimal upto)

 以单位向下取整, null 当零处理, scale以unit为准。
 以称重计价为例，称的精度0.01，每0.5计价
 当x >= 0.4时，按0.5处理，否则按0处理
 当x >= 0.9时，按1处理，否则按0.5处理

Parameters:: value - 数值; unit - 单位; upto - 单位后余数，大于等于该值则进位
Returns:: 处理结果

compareTo

public static int compareTo(BigDecimal a,
                            String b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: compareTo(BigDecimal, BigDecimal)

compareTo

public static int compareTo(BigDecimal a,
                            Number b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: compareTo(BigDecimal, BigDecimal)

compareTo

public static int compareTo(BigDecimal a,
                            BigDecimal b)

null小于一切

Parameters:: a - 数字; b - 数字
Returns:: 结果

compareTo

public static int compareTo(BigDecimal a,
                            String b,
                            int scale,
                            RoundingMode mode)

Parameters:: a - 数字; b - 数字; scale - 小数点位数，如2为0.00; mode - 舍入类型
Returns:: 结果
See Also:: compareTo(BigDecimal, BigDecimal, int, RoundingMode)

compareTo

public static int compareTo(BigDecimal a,
                            Number b,
                            int scale,
                            RoundingMode mode)

Parameters:: a - 数字; b - 数字; scale - 小数点位数，如2为0.00; mode - 舍入类型
Returns:: 结果
See Also:: compareTo(BigDecimal, BigDecimal, int, RoundingMode)

compareTo

public static int compareTo(BigDecimal a,
                            BigDecimal b,
                            int scale,
                            RoundingMode mode)

null小于一切

Parameters:: a - 数字; b - 数字; scale - 小数点位数，如2为0.00; mode - 舍入类型
Returns:: 结果

compareTo

public static int compareTo(BigDecimal a,
                            double b)

null小于一切

Parameters:: a - 数字; b - 数字
Returns:: 结果

equalsValue

public static boolean equalsValue(BigDecimal a,
                                  String b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: equalsValue(BigDecimal, BigDecimal)

equalsValue

public static boolean equalsValue(BigDecimal a,
                                  Number b)

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: equalsValue(BigDecimal, BigDecimal)

equalsValue

public static boolean equalsValue(BigDecimal a,
                                  BigDecimal b)

null == null, null != notnull

Parameters:: a - 数字; b - 数字
Returns:: 结果
See Also:: BigDecimal.compareTo(BigDecimal)

equalsValue

public static boolean equalsValue(BigDecimal a,
                                  String b,
                                  int scale,
                                  RoundingMode mode)

Parameters:: a - 数字; b - 数字; scale - 小数点位数，如2为0.00; mode - 舍入类型
Returns:: 结果
See Also:: equalsValue(BigDecimal, BigDecimal, int, RoundingMode)

equalsValue

public static boolean equalsValue(BigDecimal a,
                                  Number b,
                                  int scale,
                                  RoundingMode mode)

Parameters:: a - 数字; b - 数字; scale - 小数点位数，如2为0.00; mode - 舍入类型
Returns:: 结果
See Also:: equalsValue(BigDecimal, BigDecimal, int, RoundingMode)

equalsValue

public static boolean equalsValue(BigDecimal a,
                                  BigDecimal b,
                                  int scale,
                                  RoundingMode mode)

null == null, null != notnull

Parameters:: a - 数字; b - 数字; scale - 小数点位数，如2为0.00; mode - 舍入类型
Returns:: 结果
See Also:: BigDecimal.compareTo(BigDecimal)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(String v)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(String v,
                                                   int scale)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(String v,
                                                   int scale,
                                                   @NotNull
                                                   @NotNull BigDecimal el)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(Number v)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(Number v,
                                                   int scale)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(Number v,
                                                   int scale,
                                                   @NotNull
                                                   @NotNull BigDecimal el)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(BigDecimal v)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(BigDecimal v,
                                                   int scale)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(BigDecimal... vs)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(int scale,
                                                   BigDecimal... vs)

w

@NotNull
public static @NotNull BigDecimalUtil.W w(int scale,
                                                   Number... vs)

Class BigDecimalUtil

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

BigDecimalUtil

Method Detail

string

string

string

object

object

object

object

objects

objects

avg

avg

avg

avg

avg

avg

sum

sum

sum

prd

prd

prd

notNull

notNull

notNull

max

max

max

min

min

min

add

add

add

add

add

add

add

add

add

sub

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

pow

pow

pow

neg

neg

neg