BigDecimal.unscaledValue()返回的是原数值乘以10^scale后的BigInteger,如"123.45"对应12345(scale=2);它不是简单删小数点,也不能直接转long,应使用longValueExact()安全转换。

BigDecimal.unscaledValue() 返回的是去除小数点后、按标度(scale)还原为整数形式的 BigInteger,不是“去掉小数点后的原始长整数”,也不能直接得到 long 类型——它返回的是 BigInteger,因为原始数值可能远超 long 范围。
理解 unscaledValue() 的真实含义
一个 BigDecimal 由两部分构成:未缩放值(unscaled value,即一个整数)和标度(scale,即小数点后位数)。例如:
-
new BigDecimal("123.45")→ unscaledValue =12345,scale =2 -
new BigDecimal("0.007")→ unscaledValue =7,scale =3 -
new BigDecimal("-987.6")→ unscaledValue =-9876,scale =1
它不是简单地“删掉小数点”,而是将原数值乘以 10^scale 后得到的精确整数(用 BigInteger 表示)。
如何安全获取对应的 long 值(仅当不溢出时)
如果确认 unscaledValue 绝对在 long 范围内(−2⁶³ 到 2⁶³−1),可调用 unscaledValue().longValueExact():
分析 Java Spring Boot 后端 Controller 代码,自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
BigDecimal bd = new BigDecimal("123456789.012");
BigInteger unscaled = bd.unscaledValue(); // 123456789012
long asLong = unscaled.longValueExact(); // ✅ 成功:123456789012
若超出范围,longValueExact() 会抛出 ArithmeticException;而 longValue() 会静默截断(不推荐)。
常见误区与注意事项
- ❌ 不要写
(long) bd.unscaledValue().doubleValue()—— 浮点转换会丢失精度 - ❌ 不要假设所有
BigDecimal的 unscaledValue 都能转成long(例如new BigDecimal("1e20")的 unscaledValue 是100000000000000000000,已远超long.MAX_VALUE) - ✅ 如需字符串形式的“去掉小数点的数字”,更直观的方式是:
bd unscaledValue().toString() - ✅ 若目标是“移除小数部分(截断)”,应使用
bd.setScale(0, RoundingMode.DOWN).unscaledValue(),而非直接调 unscaledValue()
替代思路:按需选择更明确的操作
根据实际目的,可能更适合的方法有:
- 想获得「整数部分」(如 123.45 → 123):用
bd.intValue()或bd.setScale(0, RoundingMode.DOWN).longValue() - 想获得「去掉小数点后的完整数字字符串」(如 123.45 → "12345"):用
bd.unscaledValue().toString() - 想还原为原始输入的整数表示(如构造时用了字符串 "12345" 和 scale=2):unscaledValue() 正是为此设计,但结果类型是
BigInteger
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










