算术函数
概述
算术函数对数值类型进行数学运算,涵盖一元正负号、四则运算、取余、幂运算、开方、对数、指数、三角函数、取整截断、符号判断、数学常量、随机数及进制转换等完整的数学计算能力。
更多内容请参考Arithmetic Functions。
适用场景
- 数值计算:在SELECT中对字段进行加减乘除运算,实现业务指标计算。
- 精度控制:通过CEIL、FLOOR、ROUND、TRUNCATE进行数值精度转换和截断。
- 科学计算:通过三角函数、对数、指数函数进行科学和工程计算。
- 数据转换:通过BIN、HEX进行数值与进制字符串之间的转换。
- 随机采样:通过RAND生成随机数用于数据采样或测试数据构造。
约束与限制
- 整数除法会截断小数部分,如需保留小数请使用DECIMAL类型或除以DECIMAL值。
- 除以零会产生NULL结果。
- POWER和SQRT的输入和返回类型为DOUBLE。
- LN、LOG10、LOG2的输入必须大于 0,否则返回NULL。
- 三角函数SIN、COS、TAN、COT的参数为弧度而非角度;反三角函数ASIN、ACOS的输入范围分别为 [-1, 1],超出范围返回NULL。
- 若算术函数的任一输入为NULL,则结果为NULL。
- TRUNCATE直接截断而非四舍五入,与ROUND的舍入行为不同。
语法结构
| 语法 | 返回类型 | 说明 | 示例 |
|---|---|---|---|
| + numeric | 与输入相同 | 一元正号。返回numeric本身的值,不改变数值;numeric为任意数值类型(TINYINT、SMALLINT、INT、BIGINT、FLOAT、DOUBLE、DECIMAL)。 | SELECT +5; -- 5 |
| - numeric | 与输入相同 | 一元负号。返回numeric的相反数;numeric为任意数值类型。 | SELECT -5; -- -5 |
| numeric1 + numeric2 | 自动提升类型 | 加法运算。返回numeric1与numeric2的和;两操作数为任意数值类型,结果类型按SQL标准自动提升(如 INT + DOUBLE → DOUBLE)。 | SELECT 10 + 5; -- 15 |
| numeric1 - numeric2 | 自动提升类型 | 减法运算。返回numeric1减去numeric2的差;两操作数为任意数值类型,结果类型自动提升。 | SELECT 10 - 5; -- 5 |
| numeric1 * numeric2 | 自动提升类型 | 乘法运算。返回numeric1与numeric2的积;两操作数为任意数值类型,结果类型自动提升。 | SELECT 10 * 5; -- 50 |
| numeric1 / numeric2 | 自动提升类型 | 除法运算。返回numeric1除以numeric2的商;整数除法截断小数部分,如需保留小数请使用DECIMAL类型;除以零返回 NULL。 | SELECT 10 / 3; -- 3 |
| POWER(numeric1, numeric2) | DOUBLE | 幂运算。返回numeric1的numeric2次幂,即 numeric1^numeric2;两参数均为数值类型,返回 DOUBLE;若numeric1为负数且numeric2为非整数,结果为 NULL。 | SELECT POWER(2, 3); -- 8.0 |
| ABS(numeric) | 与输入相同 | 绝对值。返回numeric的绝对值;numeric为任意数值类型,返回类型与输入相同。 | SELECT ABS(-5); -- 5 |
| MOD(numeric1, numeric2) | 与输入相同 | 取余运算。返回numeric1除以numeric2的余数,与%运算符等价;numeric2为0时返回NULL;两参数为整数类型时返回整数,否则返回DECIMAL。 | SELECT MOD(10, 3); -- 1 |
| SQRT(numeric) | DOUBLE | 平方根。返回numeric的非负平方根;numeric必须为非负数值,为负时返回NULL。 | SELECT SQRT(16); -- 4.0 |
| LN(numeric) | DOUBLE | 自然对数。返回numeric的自然对数(以 e 为底);numeric必须大于 0,否则返回NULL。 | SELECT LN(2.718281828); -- 0.9999999995 |
| LOG10(numeric) | DOUBLE | 以10为底的对数。返回numeric以10为底的对数;numeric必须大于 0,否则返回NULL。 | SELECT LOG10(100); -- 2.0 |
| LOG2(numeric) | DOUBLE | 以2为底的对数。返回numeric以2为底的对数;numeric必须大于0,否则返回NULL。 | SELECT LOG2(8); -- 3.0 |
| LOG(numeric1, numeric2) | DOUBLE | 自定义底数对数。返回以numeric2为底numeric1的对数;numeric1必须大于0,numeric2必须大于0且不等于1,否则返回NULL。 | SELECT LOG(8, 2); -- 3.0 |
| EXP(numeric) | DOUBLE | 指数运算。返回e(自然常数)的numeric次幂,即 e^numeric;是LN的反函数。 | SELECT EXP(1); -- 2.718281828459045 |
| CEIL(numeric) / CEILING(numeric) | 与输入相同 | 向上取整。返回不小于numeric的最小整数;numeric为任意数值类型。 | SELECT CEIL(3.2); -- 4 |
| FLOOR(numeric) | 与输入相同 | 向下取整。返回不大于numeric的最大整数;numeric为任意数值类型。 | SELECT FLOOR(3.8); -- 3 |
| ROUND(numeric, integer) | 与输入相同 | 四舍五入。将numeric四舍五入到integer位小数;integer为正时保留对应小数位,为负时对整数位进行舍入,为0时舍入到整数。 | SELECT ROUND(3.456, 2); -- 3.46 |
| TRUNCATE(numeric, integer) | 与输入相同 | 截断。将numeric截断到integer位小数,直接丢弃多余小数位而不进行舍入;integer为正时保留对应小数位,为负时对整数位截断,为0时截断到整数。 | SELECT TRUNCATE(3.456, 2); -- 3.45 |
| SIGN(numeric) | INT | 符号函数。返回numeric的符号:numeric大于0返回 1,等于0返回 0,小于0返回-1。 | SELECT SIGN(-5); -- -1 |
| SIN(numeric) | DOUBLE | 正弦函数。返回numeric(弧度)的正弦值;numeric为数值类型,表示弧度。 | SELECT SIN(0); -- 0.0 |
| COS(numeric) | DOUBLE | 余弦函数。返回numeric(弧度)的余弦值;numeric为数值类型,表示弧度。 | SELECT COS(0); -- 1.0 |
| TAN(numeric) | DOUBLE | 正切函数。返回numeric(弧度)的正切值;numeric为数值类型,表示弧度。 | SELECT TAN(0); -- 0.0 |
| COT(numeric) | DOUBLE | 余切函数。返回numeric(弧度)的余切值,即 1/TAN(numeric);numeric为0或π的整数倍时返回NULL。 | SELECT COT(1); -- 0.6420926159343308 |
| ASIN(numeric) | DOUBLE | 反正弦函数。返回numeric的反正弦值(弧度);numeric范围必须在 [-1, 1],超出范围返回NULL。 | SELECT ASIN(1); -- 1.5707963267948966 |
| ACOS(numeric) | DOUBLE | 反余弦函数。返回numeric的反余弦值(弧度);numeric范围必须在 [-1, 1],超出范围返回NULL。 | SELECT ACOS(1); -- 0.0 |
| ATAN(numeric) | DOUBLE | 反正切函数。返回numeric的反正切值(弧度);numeric为任意数值类型,返回值范围为 (-π/2, π/2)。 | SELECT ATAN(1); -- 0.7853981633974483 |
| ATAN2(numeric1, numeric2) | DOUBLE | 双参数反正切函数。返回点 (numeric2, numeric1) 与正x轴之间的角度(弧度);与ATAN的区别在于通过两个参数确定象限,返回值范围为 (-π, π]。 | SELECT ATAN2(1, 1); -- 0.7853981633974483 |
| PI() | DOUBLE | 圆周率。返回π的近似值3.141592653589793;无参数。 | SELECT PI(); -- 3.141592653589793 |
| E() | DOUBLE | 自然常数。返回e的近似值2.718281828459045;无参数。 | SELECT E(); -- 2.718281828459045 |
| RAND() | DOUBLE | 随机数。返回 [0.0, 1.0) 范围内的伪随机DOUBLE 值;无参数,每次调用返回不同值。 | SELECT RAND(); -- 0.123...(随机值) |
| RAND(integer) | DOUBLE | 种子随机数。返回 [0.0, 1.0) 范围内的伪随机DOUBLE值;integer为种子值,相同种子产生相同的随机序列。 | SELECT RAND(1); -- 0.730...(固定种子) |
| BIN(integer) | STRING | 整数转二进制字符串。返回integer的二进制表示字符串;integer为整数类型(TINYINT、SMALLINT、INT、BIGINT),负数返回其补码的二进制表示。 | SELECT BIN(5); -- '101' |
| HEX(numeric) | STRING | 转十六进制字符串。返回numeric的十六进制表示字符串;numeric为整数类型时返回其十六进制表示,为STRING类型时将每个字符转为两位十六进制。 | SELECT HEX(255); -- 'FF' |
| BITAND | INT | BITAND函数用于执行按位与操作。按位与操作是对两个整数的二进制位逐位进行比较,当两个对应位均为1时结果位为1,否则为0。 | 详情请参见BITAND |
| BITNOT | INT | BITNOT函数用于执行按位取反操作。按位取反操作是将整数的二进制位逐位取反,即0变1、1变0。由于INT类型采用补码表示,取反后的结果需结合补码规则理解。 | 详情请参见BITNOT |
| BITOR | INT | BITOR函数用于执行按位或操作。按位或操作是对两个整数的二进制位逐位进行比较,当两个对应位中至少有一个为1时结果位为1,否则为0。 | 详情请参见BITOR |
| BITXOR | INT | BITXOR函数用于执行按位异或操作。按位异或操作是对两个整数的二进制位逐位进行比较,当两个对应位不同时结果位为1,相同时为0。 | 详情请参见BITXOR |