# 算术函数
#### 概述
算术函数对数值类型进行数学运算，涵盖一元正负号、四则运算、取余、幂运算、开方、对数、指数、三角函数、取整截断、符号判断、数学常量、随机数及进制转换等完整的数学计算能力。
更多内容请参考[Arithmetic Functions](https://nightlies.apache.org/flink/flink-docs-release-1.20/docs/dev/table/functions/systemfunctions/#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](https://support.huaweicloud.com/sqlref-flink-aidatalake/aidatalake_11_0041.html)  |
| BITNOT                         | INT    | BITNOT函数用于执行按位取反操作。按位取反操作是将整数的二进制位逐位取反，即0变1、1变0。由于INT类型采用补码表示，取反后的结果需结合补码规则理解。 | 详情请参见[BITNOT](https://support.huaweicloud.com/sqlref-flink-aidatalake/aidatalake_11_0042.html)  |
| BITOR                         | INT   | BITOR函数用于执行按位或操作。按位或操作是对两个整数的二进制位逐位进行比较，当两个对应位中至少有一个为1时结果位为1，否则为0。               | 详情请参见[BITOR](https://support.huaweicloud.com/sqlref-flink-aidatalake/aidatalake_11_0043.html)    |
| BITXOR                          | INT   | BITXOR函数用于执行按位异或操作。按位异或操作是对两个整数的二进制位逐位进行比较，当两个对应位不同时结果位为1，相同时为0。                                              | 详情请参见[BITXOR](https://support.huaweicloud.com/sqlref-flink-aidatalake/aidatalake_11_0044.html) |
   
