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