BigDecimals (polaris-toolkit 3.3.6 API)

java.lang.Object
- io.polaris.core.lang.BigDecimals

```
public class BigDecimals
extends Object
```
从以下版本开始:

Nov 21, 2024

作者:

Qt

构造器概要

构造器
构造器和说明

BigDecimals()

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

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static BigDecimal`	`defaultIfNull(BigDecimal number)` 空转0
`static BigDecimal`	`defaultIfNull(BigDecimal number, BigDecimal defaultValue)`
`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(String numberStr, int scale)` 保留固定位数小数采用四舍五入策略 `RoundingMode.HALF_UP` 例如保留2位小数：123.456789 =》 123.46
`static BigDecimal`	`round(String numberStr, int scale, RoundingMode roundingMode)` 保留固定位数小数例如保留四位小数：123.456789 =》 123.4567
`static String`	`roundAsString(String numberStr, int scale)` 保留固定位数小数采用四舍五入策略 `RoundingMode.HALF_UP` 例如保留2位小数：123.456789 =》 123.46
`static String`	`roundAsString(String numberStr, 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 BigDecimal`	`toBigDecimal(Number number)` 数字转`BigDecimal` Float、Double等有精度问题，转换为字符串后再转换 null转换为0
`static BigDecimal`	`toBigDecimal(String numberStr)` 数字转`BigDecimal` null或""或空白符转换为0
`static String`	`toString(BigDecimal bigDecimal)` `BigDecimal`数字转字符串调用`BigDecimal.toPlainString()`，并去除尾小数点儿后多余的0
`static String`	`toString(BigDecimal bigDecimal, boolean isStripTrailingZeros)` `BigDecimal`数字转字符串调用`BigDecimal.toPlainString()`，可选去除尾小数点儿后多余的0

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

- 构造器详细资料
  - BigDecimals
```
public BigDecimals()
```
- 方法详细资料
  - 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(BigDecimal number,
                               int scale)
```
    保留固定位数小数
    采用四舍五入策略 RoundingMode.HALF_UP
    例如保留2位小数：123.456789 =》 123.46
    
    参数:
    
    number - 数字值
    
    scale - 保留小数位数
    
    返回:
    
    新值
  - round
```
public static BigDecimal round(String numberStr,
                               int scale,
                               RoundingMode roundingMode)
```
    保留固定位数小数
    例如保留四位小数：123.456789 =》 123.4567
    
    参数:
    
    numberStr - 数字值的字符串表现形式
    
    scale - 保留小数位数，如果传入小于0，则默认0
    
    roundingMode - 保留小数的模式 RoundingMode，如果传入null则默认四舍五入
    
    返回:
    
    新值
  - round
```
public static BigDecimal round(String numberStr,
                               int scale)
```
    保留固定位数小数
    采用四舍五入策略 RoundingMode.HALF_UP
    例如保留2位小数：123.456789 =》 123.46
    
    参数:
    
    numberStr - 数字值的字符串表现形式
    
    scale - 保留小数位数
    
    返回:
    
    新值
  - roundAsString
```
public static String roundAsString(String numberStr,
                                   int scale,
                                   RoundingMode roundingMode)
```
    保留固定位数小数
    例如保留四位小数：123.456789 =》 123.4567
    
    参数:
    
    numberStr - 数字值的字符串表现形式
    
    scale - 保留小数位数
    
    roundingMode - 保留小数的模式 RoundingMode
    
    返回:
    
    新值
  - roundAsString
```
public static String roundAsString(String numberStr,
                                   int scale)
```
    保留固定位数小数
    采用四舍五入策略 RoundingMode.HALF_UP
    例如保留2位小数：123.456789 =》 123.46
    
    参数:
    
    numberStr - 数字值的字符串表现形式
    
    scale - 保留小数位数
    
    返回:
    
    新值
  - roundDown
```
public static BigDecimal roundDown(BigDecimal value,
                                   int scale)
```
    保留固定小数位数，舍去多余位数
    
    参数:
    
    value - 需要科学计算的数据
    
    scale - 保留的小数位
    
    返回:
    
    结果
  - roundDown
```
public static BigDecimal roundDown(Number number,
                                   int scale)
```
    保留固定小数位数，舍去多余位数
    
    参数:
    
    number - 需要科学计算的数据
    
    scale - 保留的小数位
    
    返回:
    
    结果
  - roundHalfEven
```
public static BigDecimal roundHalfEven(BigDecimal value,
                                       int scale)
```
    四舍六入五成双计算法
    四舍六入五成双是一种比较精确比较科学的计数保留法，是一种数字修约规则。
```
 算法规则:
 四舍六入五考虑，
 五后非零就进一，
 五后皆零看奇偶，
 五前为偶应舍去，
 五前为奇要进一。
 
```
    参数:
    
    value - 需要科学计算的数据
    
    scale - 保留的小数位
    
    返回:
    
    结果
  - roundHalfEven
```
public static BigDecimal roundHalfEven(Number number,
                                       int scale)
```
    另请参阅:
    
    roundHalfEven(BigDecimal, int)
  - toBigDecimal
```
public static BigDecimal toBigDecimal(Number number)
```
    数字转BigDecimal
    Float、Double等有精度问题，转换为字符串后再转换
    null转换为0
    
    参数:
    
    number - 数字
    
    返回:
    
    BigDecimal
  - toBigDecimal
```
public static BigDecimal toBigDecimal(String numberStr)
```
    数字转BigDecimal
    null或""或空白符转换为0
    
    参数:
    
    numberStr - 数字字符串
    
    返回:
    
    BigDecimal
  - toString
```
public static String toString(BigDecimal bigDecimal)
```
    BigDecimal数字转字符串
    调用BigDecimal.toPlainString()，并去除尾小数点儿后多余的0
    
    参数:
    
    bigDecimal - A BigDecimal
    
    返回:
    
    A String.
  - toString
```
public static String toString(BigDecimal bigDecimal,
                              boolean isStripTrailingZeros)
```
    BigDecimal数字转字符串
    调用BigDecimal.toPlainString()，可选去除尾小数点儿后多余的0
    
    参数:
    
    bigDecimal - A BigDecimal
    
    isStripTrailingZeros - 是否去除末尾多余0，例如5.0返回5
    
    返回:
    
    A String.
  - defaultIfNull
```
public static BigDecimal defaultIfNull(BigDecimal number,
                                       BigDecimal defaultValue)
```
  - defaultIfNull
```
public static BigDecimal defaultIfNull(BigDecimal number)
```
    空转0
    
    参数:
    
    number - BigDecimal，可以为null
    
    返回:
    
    BigDecimal参数为空时返回0的值

类 BigDecimals

构造器概要

方法概要

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

构造器详细资料

BigDecimals

方法详细资料

round

round

round

round

roundAsString

roundAsString

roundDown

roundDown

roundHalfEven

roundHalfEven

toBigDecimal

toBigDecimal

toString

toString

defaultIfNull

defaultIfNull