Hive函数大全（含例子）之数学函数（Mathematical Functions）

为了方便测试，创建了dual表，该表只有一个字段以及只有一行数据，建表语句如下：

CREATE TABLE dual (
x INT
)

round(DOUBLE a)，返回类型：DOUBLE

返回数字 a 四舍五入后的值

• select round(1.5) from dual; -- 结果为 2
• select round(1.1) from dual; -- 结果为 1

round(DOUBLE a, INT d)，返回类型：DOUBLE

返回数字 a 四舍五入到小数点后 d 位的值

• select round(1.15, 1) from dual; -- 结果为 1.2
• select round(1.12, 1) from dual; -- 结果为 1.1
• select round(1.12, 3) from dual; -- 结果为 1.12
• select round(1.12, 0) from dual; -- 结果为 1.0
• select round(1.12, -1) from dual; -- 结果为 0.0

bround(DOUBLE a)，返回类型：DOUBLE

返回数字 a 高斯舍入后的值

高斯舍入也称银行家舍入，简单的说就是四舍六入五考虑，五后非空就进一，五后为空看奇偶，五前为偶应舍去，五前为奇要进一

• -- 四舍
• select bround(1.4) from dual; -- 结果为 1.0
• -- 六入
• select bround(1.6) from dual; -- 结果为 2.0
• -- 五后非空就进一
• select bround(1.51) from dual; -- 结果为 2.0
• -- 五前为偶应舍去
• select bround(2.5) from dual; -- 结果为 2.0
• -- 五前为奇要进一
• select bround(3.5) from dual; -- 结果为 4.0

bround(DOUBLE a, INT d)，返回类型：DOUBLE

返回数字 a 高斯舍入到小数点后 d 位的值

• -- 四舍
• select bround(1.14, 1) from dual; -- 结果为 1.1
• -- 六入
• select bround(1.16, 1) from dual; -- 结果为 1.2
• -- 五后非空就进一
• select bround(1.151, 1) from dual; -- 结果为 1.2
• -- 五前为偶应舍去
• select bround(1.25, 1) from dual; -- 结果为 1.2
• -- 五前为奇要进一
• select bround(1.35, 1) from dual; -- 结果为 1.4

floor(DOUBLE a)，返回类型：BIGINT

对数字 a 向下取整

• select floor(1.1) from dual; -- 结果为 1
• select floor(1.6) from dual; -- 结果为 1
• select floor(-1.1) from dual; -- 结果为 -2
• select floor(-1.6) from dual; -- 结果为 -2

ceil(DOUBLE a), ceiling(DOUBLE a)，返回类型：BIGINT

对数字 a 向上取整，ceil同ceiling

• select ceil(1.1) from dual; -- 结果为 2
• select ceil(1.6) from dual; -- 结果为 2
• select floor(-1.1) from dual; -- 结果为 -1
• select floor(-1.6) from dual; -- 结果为 -1

rand(), rand(INT seed)，返回类型：DOUBLE

如果?seed 不指定，则返回0到1之间的随机数，如：

• select rand() from dual; -- 结果为 0.9811062452094043

如果 seed 指定了，随机数是确定的，如：

• select rand(2) from dual; -- 结果为 0.7311469360199058
• select rand(2020) from dual; -- 结果为 0.6188119599189963
• select rand(20201231) from dual; -- 结果为 0.9412005456293369

一般使用Unix时间戳作为seed

exp(DOUBLE a), exp(DECIMAL a)，返回类型：DOUBLE

返回 e 的 a 次方

• select exp(1) from dual; -- 结果为 2.718281828459045
• select exp(1.5) from dual; -- 结果为 4.4816890703380645
• select exp(2) from dual; -- 结果为 7.38905609893065
• select exp(0) from dual; -- 结果为 1.0
• select exp(-1) from dual; -- 结果为 0.36787944117144233

ln(DOUBLE a), ln(DECIMAL a)，返回类型：DOUBLE

返回以 e 为底，a 的对数

• select ln(0) from dual; -- 结果为 NULL
• select ln(1) from dual; -- 结果为 0.0
• select ln(2) from dual; -- 结果为 0.6931471805599453
• select ln(2.718281828459045) from dual; -- 结果为 1.0

log10(DOUBLE a), log10(DECIMAL a)，返回类型：DOUBLE

返回以 10 为底，a 的对数

• select log10(1) from dual; -- 结果为 0.0
• select log10(10) from dual; -- 结果为 1.0
• select log10(0.1) from dual; -- 结果为 -1.0

log2(DOUBLE a), log2(DECIMAL a)，返回类型：DOUBLE

返回以 2 为底，a 的对数

• select log10(1) from dual; -- 结果为 0.0
• select log10(10) from dual; -- 结果为 1.0
• select log10(0.1) from dual; -- 结果为 -1.0

log(DOUBLE base, DOUBLE a)，log(DECIMAL base, DECIMAL a)，返回类型：DOUBLE

返回以 base 为底，a 的对数

• select log(1.1, 1.21) from dual; -- 结果为 1.9999999999999982
• select log(2, 4) from dual; -- 结果为 2.0
• select log(3.1, 5) from dual; -- 结果为 1.4225162708181491

pow(DOUBLE a, DOUBLE p), power(DOUBLE a, DOUBLE p)，返回类型：DOUBLE

返回 a 的 p 次方

• select pow(-1, 2) from dual; -- 结果为 1.0
• select pow(0, 1.21) from dual; -- 结果为 0.0
• select pow(1.1, 2) from dual; -- 结果为 1.2100000000000002

sqrt(DOUBLE a), sqrt(DECIMAL a)，返回类型：DOUBLE

返回 a 的 平方根

• select sqrt(4) from dual; -- 结果为 2.0
• select sqrt(1.21) from dual; -- 结果为 1.1
• select sqrt(-1) from dual; -- 结果为 NULL

bin(BIGINT a)，返回类型：STRING

返回 a 的 二进制表达式

• select bin(-1024) from dual; -- 结果为 1111111111111111111111111111111111111111111111111111110000000000
• select bin(-1) from dual; -- 结果为 1111111111111111111111111111111111111111111111111111111111111111
• select bin(1) from dual; -- 结果为 1
• select bin(1024) from dual; -- 结果为 10000000000

hex(BIGINT a) hex(STRING a) hex(BINARY a)，返回类型：STRING

如果参数 a 是整数，则返回十六进制表达式，如：

• select hex(16) from dual; -- 结果为 10
• select bin(-1024) from dual; -- 结果为
• select bin(-1024) from dual; -- 结果为
• select bin(-1024) from dual; -- 结果为

如果参数 a 是字符串，则逐一将字符串中的每个字符对应的ASCII码以十六进制表示并返回，如：

• select hex(16) from dual; -- 结果为 10
• select hex(11) from dual; -- 结果为 B
• select hex(-1) from dual; -- 结果为 FFFFFFFFFFFFFFFF

unhex(STRING a)，返回类型：STRING

hex的逆函数，以十六进制解释参数 a ，并进行ASCII转换，返回对应的字符

• select unhex('41') from dual; -- 结果为 A
• select unhex('42') from dual; -- 结果为 B
• select unhex('4242') from dual; -- 结果为 BB

conv(BIGINT num, INT from_base, INT to_base), conv(STRING num, INT from_base, INT to_base)，返回类型：STRING

将数字 num 或者字符串 num 从 from_base 进制转换到 to_base 进制

• select conv('1024', 10, 2) from dual; -- 结果为 10000000000
• select conv(1024, 10, 2) from dual; -- 结果为 10000000000
• select conv(10000000000, 2, 10) from dual; -- 结果为 1024
• select conv('A', 16, 10) from dual; -- 结果为 1

abs(DOUBLE a)，返回类型：DOUBLE

返回 a 的绝对值

• select abs('-1.024') from dual; -- 结果为 1.024
• select abs('1.024') from dual; -- 结果为 1.024

pmod(INT a, INT b), pmod(DOUBLE a, DOUBLE b)，返回类型：INT or DOUBLE

返回 a 模 b 的值，pmod(a, b) 同 a % b

• select pmod(10, 3) from dual; -- 结果为 1
• select 10 % 3 from dual; -- 结果为 1
• select pmod(10.1, 2.5) from dual; -- 结果为 0.09999999999999964
• select 10.1 % 2.5 from dual; -- 结果为 0.09999999999999964
• select pmod(10, 2.5) from dual; -- 结果为 0.0

sin(DOUBLE a), sin(DECIMAL a)，返回类型：DOUBLE

返回 a 的正弦值（a以弧度为单位，1弧度(rad)=57.29578度(°)）

• select sin(1) from dual; -- 结果为 0.8414709848078965
• select sin(1 / 57.29578 * 90) from dual; -- 结果为 0.9999999999999999

asin(DOUBLE a), asin(DECIMAL a)，返回类型：DOUBLE

返回 a 的反正弦值（-1<=a<=1）

• select asin(0.8414709848078965) from dual; -- 结果为 1.0
• select asin(1) * 57.29578 from dual; -- 结果为 90.0000007648485
• select asin(10) from dual; -- 结果为 NaN

cos(DOUBLE a), cos(DECIMAL a)，返回类型：DOUBLE

返回 a 的余弦值

• select cos(1) from dual; -- 结果为 0.5403023058681398
• select cos(1 / 57.29578 * 120) from dual; -- 结果为 -0.4999999845857585

acos(DOUBLE a), acos(DECIMAL a)，返回类型：DOUBLE

返回 a 的反余弦值

• select acos(0.5403023058681398) from dual; -- 结果为 1.0
• select acos(0.5) * 57.29578 from dual; -- 结果为 60.00000050989901

tan(DOUBLE a), tan(DECIMAL a)，返回类型：DOUBLE

返回 a 的正切值

• select tan(1) from dual; -- 结果为 1.5574077246549023
• select tan(1 / 57.29578 * 45) from dual; -- 结果为 0.9999999866508755

atan(DOUBLE a), atan(DECIMAL a)，返回类型：DOUBLE

返回 a 的反正切值

• select atan(1.5574077246549023) from dual; -- 结果为 1.0
• select atan(1) * 57.29578 from dual; -- 结果为 45.00000038242425

degrees(DOUBLE a), degrees(DECIMAL a)，返回类型：DOUBLE

弧度(rad)转为度(°)：1弧度(rad)=57.29577951308232度(°)

• select degrees(1) from dual; -- 结果为 57.29577951308232

radians(DOUBLE a), radians(DOUBLE a)，返回类型：DOUBLE

度(°)转为弧度(rad)

• select radians(57.29577951308232) from dual; -- 结果为 1.0
• select radians(90) from dual; -- 结果为 1.5707963267948966

positive(INT a), positive(DOUBLE a)，返回类型：INT or DOUBLE

返回 a

• select positive(1) from dual; -- 结果为 1
• select positive(-1) from dual; -- 结果为 -1
• select positive(1.024) from dual; -- 结果为 1.024

negative(INT a), negative(DOUBLE a)，返回类型：INT or DOUBLE

返回 -a

• select negative(1) from dual; -- 结果为 -1
• select negative(-1) from dual; -- 结果为 1
• select negative(1.024) from dual; -- 结果为 -1.024

sign(DOUBLE a), sign(DECIMAL a)，返回类型：DOUBLE or INT

如果 a 是正数，返回 1.0；如果 a 是负数，返回 -1.0；如果 a 是 0，返回 0.0

• select sign(2) from dual; -- 结果为 1.0
• select sign(-2) from dual; -- 结果为 -1.0
• select sign(0) from dual; -- 结果为 0.0
• select sign(0) from dual; -- 结果为 0.0

e()，返回类型：DOUBLE

返回自然常数 e 的值

• select e() from dual; -- 结果为 2.718281828459045

pi()，返回类型：DOUBLE

返回圆周率 Pi 的值

• select pi() from dual; -- 结果为 3.141592653589793

factorial(INT a)，返回类型：BIGINT

返回 a 的阶乘（n!=1×2×3×...×(n-1)×n）

• select factorial(3) from dual; -- 结果为 6
• select factorial(4) from dual; -- 结果为 24

cbrt(DOUBLE a)，返回类型：DOUBLE

返回 a 的立方根

• select cbrt(8) from dual; -- 结果为 2.0
• select cbrt(1.331) from dual; -- 结果为 1.1

shiftleft(TINYINT|SMALLINT|INT a, INT b)，shiftleft(BIGINT a, INT b)，返回类型：INT or BIGINT

按位左移

• select shiftleft(1, 1) from dual; -- 结果为 2
• select shiftleft(1, 2) from dual; -- 结果为 4
• select shiftleft(1024) from dual; -- 结果为 111111

shiftright(TINYINT|SMALLINT|INT a, INT b)，shiftright(BIGINT a, INT b)，返回类型：INT or BIGINT

按位右移

• select shiftright(1, 1) from dual; -- 结果为 0
• select shiftright(1, 1) from dual; -- 结果为 0
• select shiftright(1024, 1) from dual; -- 结果为 512
• select shiftright(1024, 0) from dual; -- 结果为 1024
• select shiftright(1024, -1) from dual; -- 结果为 0

shiftrightunsigned(TINYINT|SMALLINT|INT a, INT b)，shiftrightunsigned(BIGINT a, INT b)，返回类型：DOUBLE

按位无符号右移

• select shiftrightunsigned(2, 1) from dual; -- 结果为 1
• select shiftrightunsigned(1, 1) from dual; -- 结果为 0
• select shiftrightunsigned(0, 1) from dual; -- 结果为 0
• select shiftrightunsigned(-1, 1) from dual; -- 结果为 2147483647
• select shiftrightunsigned(-2, 1) from dual; -- 结果为 2147483647

greatest(T v1, T v2, ...)，返回类型：T

返回最大值（如果列表中有一个值为NULL，则返回NULL）

• select greatest(2, 3) from dual; -- 结果为 3
• select greatest('11', '12', '9') from dual; -- 结果为 9
• select greatest(NULL, 1, 2) from dual; -- 结果为 NULL

least(T v1, T v2, ...)，返回类型：T

返回最小值（如果列表中有一个值为NULL，则返回NULL）

• select least(2, 3) from dual; -- 结果为 2
• select least('11', '12', '9') from dual; -- 结果为 11
• select least(NULL, 1, 2) from dual; -- 结果为 NULL

width_bucket(NUMERIC expr, NUMERIC min_value, NUMERIC max_value, INT num_buckets)，返回类型：INT

返回一个介于 0 和 num_buckets + 1 之间的整数（基于通过将[min_value，max_value]划分为大小相等的区域来生成存储桶）；

如果 expr 小于 min_value 则返回1，如果 expr 大于 max_value 则返回 num_buckets + 1

• select width_bucket(2, 1, 10, 5) from dual; -- 结果为 1
• select width_bucket(1, 2, 11, 5) from dual; -- 结果为 1
• select width_bucket(11, 1, 10, 5) from dual; -- 结果为 6