Class NumberUtil

java.lang.Object
com.sure.tool.util.NumberUtil

public class NumberUtil extends Object
数字工具类,参考 Hutool 的 NumberUtil 设计。

提供安全的数值解析、高精度运算、格式化等静态方法。

English: Number parsing, rounding, formatting and range checks.

Since:
0.1.0
Author:
suretool
  • Method Summary

    Modifier and Type
    Method
    Description
    static double
    add(double v1, double v2)
    加法(基于 BigDecimal,避免浮点误差)。
    static long
    add(long v1, long v2)
    long 加法(溢出时抛出 ArithmeticException)。
    static long
    ceil(double value)
    向上取整。
    static String
    decimalFormat(double value, String format)
    数字格式化,如 decimalFormat(12345.678, "#,##0.00") → "12,345.68"。
    static double
    div(double v1, double v2, int scale)
    除法(基于 BigDecimal,按指定小数位四舍五入)。
    static long
    factorial(int n)
    阶乘。
    static long
    floor(double value)
    向下取整。
    static long
    gcd(long a, long b)
    最大公约数(欧几里得算法)。
    static boolean
    字符串是否为浮点数(含小数或指数形式)。
    static boolean
    isEquals(double v1, double v2, double delta)
    两个 double 在指定误差范围内是否相等。
    static boolean
    isEven(long value)
    是否为偶数。
    static boolean
    字符串是否为整数。
    static boolean
    是否为 long 字符串。
    static boolean
    字符串是否为数字(支持小数、负数、科学计数法)。
    static boolean
    isOdd(long value)
    是否为奇数。
    static boolean
    isPrime(int n)
    素数判断(质数)。
    static long
    lcm(long a, long b)
    最小公倍数。
    static Number
    max(Number... numbers)
    求最大值(null 元素忽略,全为 null 返回 null)。
    static Number
    min(Number... numbers)
    求最小值(null 元素忽略,全为 null 返回 null)。
    static double
    mul(double v1, double v2)
    乘法(基于 BigDecimal)。
    static byte
    parseByte(String str, byte defaultValue)
    字符串转 byte,解析失败返回默认值。
    static double
    字符串转 double,解析失败抛出 NumberFormatException。
    static double
    parseDouble(String str, double defaultValue)
    字符串转 double,解析失败返回默认值。
    static float
    parseFloat(String str, float defaultValue)
    字符串转 float,解析失败返回默认值。
    static int
    字符串转 int,解析失败抛出 NumberFormatException。
    static int
    parseInt(String str, int defaultValue)
    字符串转 int,解析失败返回默认值。
    static long
    字符串转 long,解析失败抛出 NumberFormatException。
    static long
    parseLong(String str, long defaultValue)
    字符串转 long,解析失败返回默认值。
    static Number
    解析字符串为数字类型(Integer/Long/BigDecimal)。
    static short
    parseShort(String str, short defaultValue)
    字符串转 short,解析失败返回默认值。
    static int[]
    partValue(int total, int... weights)
    整数按权重分配(总和不变,余数按权重余数依次+1)。
    static String
    percent(double value, int scale)
    转为百分比字符串(如 0.3456 -> "34.56%")。
    static long
    pow(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 BigDecimal
    round(double value, int scale)
    四舍五入保留指定小数位。
    static BigDecimal
    round(String value, int scale)
    字符串数值四舍五入保留指定小数位。
    static double
    sub(double v1, double v2)
    减法(基于 BigDecimal)。
    static String
    toBinaryStr(int value)
    int 转二进制字符串(含符号位)。
    static String
    toFixed(double value, int scale)
    保留指定小数位(四舍五入)。
    static String
    toFixed(BigDecimal value, int scale)
    保留指定小数位(四舍五入)。
    static String
    toHexStr(int value)
    int 转十六进制字符串。
    static String
    toStr(double value)
    数值转普通字符串(避免科学计数法,如 1.0E-4 → 0.0001)。

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Method Details

    • parseInt

      public static int parseInt(String str)
      字符串转 int,解析失败抛出 NumberFormatException。
      Parameters:
      str - 字符串
      Returns:
      int 值
    • parseInt

      public static int parseInt(String str, int defaultValue)
      字符串转 int,解析失败返回默认值。
      Parameters:
      str - 字符串
      defaultValue - 默认值
      Returns:
      int 值或默认值
    • parseLong

      public static long parseLong(String str)
      字符串转 long,解析失败抛出 NumberFormatException。
      Parameters:
      str - 字符串
      Returns:
      long 值
    • parseLong

      public static long parseLong(String str, long defaultValue)
      字符串转 long,解析失败返回默认值。
      Parameters:
      str - 字符串
      defaultValue - 默认值
      Returns:
      long 值或默认值
    • parseDouble

      public static double parseDouble(String str)
      字符串转 double,解析失败抛出 NumberFormatException。
      Parameters:
      str - 字符串
      Returns:
      double 值
    • parseDouble

      public static double parseDouble(String str, double defaultValue)
      字符串转 double,解析失败返回默认值。
      Parameters:
      str - 字符串
      defaultValue - 默认值
      Returns:
      double 值或默认值
    • parseFloat

      public static float parseFloat(String str, float defaultValue)
      字符串转 float,解析失败返回默认值。
      Parameters:
      str - 字符串
      defaultValue - 默认值
      Returns:
      float 值或默认值
    • parseShort

      public static short parseShort(String str, short defaultValue)
      字符串转 short,解析失败返回默认值。
      Parameters:
      str - 字符串
      defaultValue - 默认值
      Returns:
      short 值或默认值
    • parseByte

      public static byte parseByte(String str, byte defaultValue)
      字符串转 byte,解析失败返回默认值。
      Parameters:
      str - 字符串
      defaultValue - 默认值
      Returns:
      byte 值或默认值
    • isNumber

      public static boolean isNumber(String str)
      字符串是否为数字(支持小数、负数、科学计数法)。
      Parameters:
      str - 字符串
      Returns:
      是否为数字
    • isInteger

      public static boolean isInteger(String str)
      字符串是否为整数。
      Parameters:
      str - 字符串
      Returns:
      是否为整数
    • isDouble

      public static boolean isDouble(String str)
      字符串是否为浮点数(含小数或指数形式)。
      Parameters:
      str - 字符串
      Returns:
      是否为浮点数
    • round

      public static BigDecimal round(double value, int scale)
      四舍五入保留指定小数位。
      Parameters:
      value - 数值
      scale - 小数位
      Returns:
      四舍五入后的 BigDecimal
    • round

      public static BigDecimal round(String value, int scale)
      字符串数值四舍五入保留指定小数位。
      Parameters:
      value - 数值字符串
      scale - 小数位
      Returns:
      四舍五入后的 BigDecimal
    • add

      public static double add(double v1, double v2)
      加法(基于 BigDecimal,避免浮点误差)。
      Parameters:
      v1 - 加数 1
      v2 - 加数 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 - 乘数 1
      v2 - 乘数 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 - 加数 1
      v2 - 加数 2
      Returns:
      和
    • isEquals

      public static boolean isEquals(double v1, double v2, double delta)
      两个 double 在指定误差范围内是否相等。
      Parameters:
      v1 - 值 1
      v2 - 值 2
      delta - 误差范围
      Returns:
      是否相等
    • isEven

      public static boolean isEven(long value)
      是否为偶数。
      Parameters:
      value - 数值
      Returns:
      是否为偶数
    • isOdd

      public static boolean isOdd(long value)
      是否为奇数。
      Parameters:
      value - 数值
      Returns:
      是否为奇数
    • decimalFormat

      public static String decimalFormat(double value, String format)
      数字格式化,如 decimalFormat(12345.678, "#,##0.00") → "12,345.68"。
      Parameters:
      value - 数值
      format - 格式
      Returns:
      格式化后的字符串
    • toBinaryStr

      public static String toBinaryStr(int value)
      int 转二进制字符串(含符号位)。
      Parameters:
      value - 数值
      Returns:
      二进制字符串
    • toHexStr

      public static String toHexStr(int value)
      int 转十六进制字符串。
      Parameters:
      value - 数值
      Returns:
      十六进制字符串
    • toStr

      public static String toStr(double value)
      数值转普通字符串(避免科学计数法,如 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

      public static Number max(Number... numbers)
      求最大值(null 元素忽略,全为 null 返回 null)。
      Parameters:
      numbers - 数字数组
      Returns:
      最大值
    • min

      public static Number min(Number... numbers)
      求最小值(null 元素忽略,全为 null 返回 null)。
      Parameters:
      numbers - 数字数组
      Returns:
      最小值
    • 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

      public static boolean isLong(String str)
      是否为 long 字符串。
      Parameters:
      str - 字符串
      Returns:
      是否为 long
    • percent

      public static String percent(double value, int scale)
      转为百分比字符串(如 0.3456 -> "34.56%")。
      Parameters:
      value - 比率(0-1)
      scale - 保留小数位
      Returns:
      百分比字符串
    • toFixed

      public static String toFixed(double value, int scale)
      保留指定小数位(四舍五入)。
      Parameters:
      value - 数值
      scale - 小数位数
      Returns:
      格式化后的字符串
    • toFixed

      public static String toFixed(BigDecimal value, int scale)
      保留指定小数位(四舍五入)。
      Parameters:
      value - 数值
      scale - 小数位数
      Returns:
      格式化后的字符串
    • parseNumber

      public static Number parseNumber(String value)
      解析字符串为数字类型(Integer/Long/BigDecimal)。
      Parameters:
      value - 字符串
      Returns:
      Number;无法解析返回 null
    • 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 次幂