Class NumberUtil
java.lang.Object
com.sure.tool.util.NumberUtil
数字工具类,参考 Hutool 的
NumberUtil 设计。
提供安全的数值解析、高精度运算、格式化等静态方法。
English: Number parsing, rounding, formatting and range checks.
- Since:
- 0.1.0
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionstatic doubleadd(double v1, double v2) 加法(基于BigDecimal,避免浮点误差)。static longadd(long v1, long v2) long 加法(溢出时抛出ArithmeticException)。static longceil(double value) 向上取整。static StringdecimalFormat(double value, String format) 数字格式化,如decimalFormat(12345.678, "#,##0.00")→"12,345.68"。static doublediv(double v1, double v2, int scale) 除法(基于BigDecimal,按指定小数位四舍五入)。static longfactorial(int n) 阶乘。static longfloor(double value) 向下取整。static longgcd(long a, long b) 最大公约数(欧几里得算法)。static boolean字符串是否为浮点数(含小数或指数形式)。static booleanisEquals(double v1, double v2, double delta) 两个 double 在指定误差范围内是否相等。static booleanisEven(long value) 是否为偶数。static boolean字符串是否为整数。static boolean是否为 long 字符串。static boolean字符串是否为数字(支持小数、负数、科学计数法)。static booleanisOdd(long value) 是否为奇数。static booleanisPrime(int n) 素数判断(质数)。static longlcm(long a, long b) 最小公倍数。static Number求最大值(null 元素忽略,全为 null 返回null)。static Number求最小值(null 元素忽略,全为 null 返回null)。static doublemul(double v1, double v2) 乘法(基于BigDecimal)。static byte字符串转 byte,解析失败返回默认值。static doubleparseDouble(String str) 字符串转 double,解析失败抛出NumberFormatException。static doubleparseDouble(String str, double defaultValue) 字符串转 double,解析失败返回默认值。static floatparseFloat(String str, float defaultValue) 字符串转 float,解析失败返回默认值。static int字符串转 int,解析失败抛出NumberFormatException。static int字符串转 int,解析失败返回默认值。static long字符串转 long,解析失败抛出NumberFormatException。static long字符串转 long,解析失败返回默认值。static NumberparseNumber(String value) 解析字符串为数字类型(Integer/Long/BigDecimal)。static shortparseShort(String str, short defaultValue) 字符串转 short,解析失败返回默认值。static int[]partValue(int total, int... weights) 整数按权重分配(总和不变,余数按权重余数依次+1)。static Stringpercent(double value, int scale) 转为百分比字符串(如 0.3456 -> "34.56%")。static longpow(long base, int exponent) 幂运算。static int[]range(int start, int end) 生成整数序列 [start, end)。static int[]range(int start, int end, int step) 生成整数序列 [start, end)(指定步长)。static long[]range(long start, long end, long step) 生成长整型序列 [start, end)(指定步长)。static BigDecimalround(double value, int scale) 四舍五入保留指定小数位。static BigDecimal字符串数值四舍五入保留指定小数位。static doublesub(double v1, double v2) 减法(基于BigDecimal)。static StringtoBinaryStr(int value) int 转二进制字符串(含符号位)。static StringtoFixed(double value, int scale) 保留指定小数位(四舍五入)。static StringtoFixed(BigDecimal value, int scale) 保留指定小数位(四舍五入)。static StringtoHexStr(int value) int 转十六进制字符串。static StringtoStr(double value) 数值转普通字符串(避免科学计数法,如 1.0E-4 → 0.0001)。
-
Method Details
-
parseInt
字符串转 int,解析失败抛出NumberFormatException。- Parameters:
str- 字符串- Returns:
- int 值
-
parseInt
字符串转 int,解析失败返回默认值。- Parameters:
str- 字符串defaultValue- 默认值- Returns:
- int 值或默认值
-
parseLong
字符串转 long,解析失败抛出NumberFormatException。- Parameters:
str- 字符串- Returns:
- long 值
-
parseLong
字符串转 long,解析失败返回默认值。- Parameters:
str- 字符串defaultValue- 默认值- Returns:
- long 值或默认值
-
parseDouble
字符串转 double,解析失败抛出NumberFormatException。- Parameters:
str- 字符串- Returns:
- double 值
-
parseDouble
字符串转 double,解析失败返回默认值。- Parameters:
str- 字符串defaultValue- 默认值- Returns:
- double 值或默认值
-
parseFloat
字符串转 float,解析失败返回默认值。- Parameters:
str- 字符串defaultValue- 默认值- Returns:
- float 值或默认值
-
parseShort
字符串转 short,解析失败返回默认值。- Parameters:
str- 字符串defaultValue- 默认值- Returns:
- short 值或默认值
-
parseByte
字符串转 byte,解析失败返回默认值。- Parameters:
str- 字符串defaultValue- 默认值- Returns:
- byte 值或默认值
-
isNumber
字符串是否为数字(支持小数、负数、科学计数法)。- Parameters:
str- 字符串- Returns:
- 是否为数字
-
isInteger
-
isDouble
字符串是否为浮点数(含小数或指数形式)。- Parameters:
str- 字符串- Returns:
- 是否为浮点数
-
round
四舍五入保留指定小数位。- Parameters:
value- 数值scale- 小数位- Returns:
- 四舍五入后的
BigDecimal
-
round
字符串数值四舍五入保留指定小数位。- Parameters:
value- 数值字符串scale- 小数位- Returns:
- 四舍五入后的
BigDecimal
-
add
public static double add(double v1, double v2) 加法(基于BigDecimal,避免浮点误差)。- Parameters:
v1- 加数 1v2- 加数 2- Returns:
- 和
-
sub
public static double sub(double v1, double v2) 减法(基于BigDecimal)。- Parameters:
v1- 被减数v2- 减数- Returns:
- 差
-
mul
public static double mul(double v1, double v2) 乘法(基于BigDecimal)。- Parameters:
v1- 乘数 1v2- 乘数 2- Returns:
- 积
-
div
public static double div(double v1, double v2, int scale) 除法(基于BigDecimal,按指定小数位四舍五入)。- Parameters:
v1- 被除数v2- 除数scale- 小数位- Returns:
- 商
-
add
public static long add(long v1, long v2) long 加法(溢出时抛出ArithmeticException)。- Parameters:
v1- 加数 1v2- 加数 2- Returns:
- 和
-
isEquals
public static boolean isEquals(double v1, double v2, double delta) 两个 double 在指定误差范围内是否相等。- Parameters:
v1- 值 1v2- 值 2delta- 误差范围- Returns:
- 是否相等
-
isEven
public static boolean isEven(long value) 是否为偶数。- Parameters:
value- 数值- Returns:
- 是否为偶数
-
isOdd
public static boolean isOdd(long value) 是否为奇数。- Parameters:
value- 数值- Returns:
- 是否为奇数
-
decimalFormat
-
toBinaryStr
int 转二进制字符串(含符号位)。- Parameters:
value- 数值- Returns:
- 二进制字符串
-
toHexStr
-
toStr
数值转普通字符串(避免科学计数法,如 1.0E-4 → 0.0001)。- Parameters:
value- 数值- Returns:
- 普通十进制字符串
-
range
public static int[] range(int start, int end) 生成整数序列 [start, end)。- Parameters:
start- 起始(含)end- 结束(不含)- Returns:
- 序列数组
-
range
public static int[] range(int start, int end, int step) 生成整数序列 [start, end)(指定步长)。- Parameters:
start- 起始(含)end- 结束(不含)step- 步长(>0)- Returns:
- 序列数组
-
range
public static long[] range(long start, long end, long step) 生成长整型序列 [start, end)(指定步长)。- Parameters:
start- 起始(含)end- 结束(不含)step- 步长(>0)- Returns:
- 序列数组
-
max
-
min
-
factorial
public static long factorial(int n) 阶乘。- Parameters:
n- 非负整数- Returns:
- n!
-
gcd
public static long gcd(long a, long b) 最大公约数(欧几里得算法)。- Parameters:
a- 整数b- 整数- Returns:
- 最大公约数(非负)
-
lcm
public static long lcm(long a, long b) 最小公倍数。- Parameters:
a- 整数b- 整数- Returns:
- 最小公倍数(非负)
-
isPrime
public static boolean isPrime(int n) 素数判断(质数)。- Parameters:
n- 正整数- Returns:
- 是否素数;n < 2 返回 false
-
partValue
public static int[] partValue(int total, int... weights) 整数按权重分配(总和不变,余数按权重余数依次+1)。- Parameters:
total- 总数(≥0)weights- 权重- Returns:
- 分配结果(长度与权重一致)
-
isLong
-
percent
转为百分比字符串(如 0.3456 -> "34.56%")。- Parameters:
value- 比率(0-1)scale- 保留小数位- Returns:
- 百分比字符串
-
toFixed
保留指定小数位(四舍五入)。- Parameters:
value- 数值scale- 小数位数- Returns:
- 格式化后的字符串
-
toFixed
保留指定小数位(四舍五入)。- Parameters:
value- 数值scale- 小数位数- Returns:
- 格式化后的字符串
-
parseNumber
-
floor
public static long floor(double value) 向下取整。- Parameters:
value- 数值- Returns:
- 不大于该数的最大整数
-
ceil
public static long ceil(double value) 向上取整。- Parameters:
value- 数值- Returns:
- 不小于该数的最小整数
-
pow
public static long pow(long base, int exponent) 幂运算。- Parameters:
base- 底数exponent- 指数(非负)- Returns:
- base 的 exponent 次幂
-