函数 | 米二

[toc]

条件函数

assert_true(BOOLEAN condition)

解释

如果condition不为true，则抛出异常，否则返回null

使用案例

select assert_true(1<2) -- 返回null
select assert_true(1>2) -- 抛出异常

coalesce(T v1, T v2, &mldr;)

解释

返回第一个不为null的值，如果都为null，则返回null

使用案例

select coalesce(null,1,2,null)  -- 返回1
select coalesce(1,null) -- 返回1
select coalesce(null,null) -- 返回null

if

if ( BOOLEAN testCondition, T valueTrue , T valueFalseOrNull )

解释

如果testCondition条件为true，则返回第一个值，否则返回第二个值

使用案例

select if(1 is null,0,1)  -- 返回1
select if(null is null,0,1) -- 返回0

isnotnull(a)

解释

如果参数a不为null，则返回true，否则返回false

使用案例

select isnotnull(1) -- 返回true
select isnotnull(null) -- 返回false

isnull(a)

解释

与isnotnull相反，如果参数a为null，则返回true，否则返回false

使用案例

select isnull(null) -- 返回true
select isnull(1) -- 返回false

nullif(a, b)

解释

如果参数a=b，返回null，否则返回a值(Hive2.2.0版本)

使用案例

select nullif(1,2) -- 返回1
select nullif(1,1) -- 返回null

nvl(T value, T default_value)

解释

如果value的值为null，则返回default_value默认值，否则返回value的值。在null值判断时，可以使用if函数给定默认值，也可以使用此函数给定默认值，使用该函数sql特别简洁。

使用案例

select nvl(1,0) -- 返回1
select nvl(null,0) -- 返回0

日期函数

add_months

add_month( DATE | STRING | TIMESTAMP start_date , INT num_months)

解释

start_date参数可以是string, date 或者timestamp类型，num_months参数时int类型。返回一个日期，该日期是在start_date基础之上加上num_months个月，即start_date之后null_months个月的一个日期。如果start_date的时间部分的数据会被忽略。注意：如果start_date所在月份的天数大于结果日期月的天数，则返回结果月的最后一天的日期。

使用案例

select add_months("2020-05-20",2); -- 返回2020-07-20
select add_months("2020-05-20",8); -- 返回2021-01-20
select add_months("2020-05-31",1); -- 返回2020-06-30,5月有31天，6月只有30天，所以返回下一个月的最后一天

current_date

解释

返回查询时刻的当前日期

使用案例

select current_date() -- 返回当前查询日期2020-05-20

current_timestamp()

解释

返回查询时刻的当前时间

使用案例

select current_timestamp() -- 2020-05-20 14:40:47.273

datediff(STRING enddate, STRING startdate)

解释

返回开始日期startdate与结束日期enddate之前相差的天数

使用案例

select datediff("2020-05-20","2020-05-21"); -- 返回-1
select datediff("2020-05-21","2020-05-20"); -- 返回1

date_add(DATE startdate, INT days)

解释

在startdate基础上加上几天，然后返回加上几天之后的一个日期

使用案例

select date_add("2020-05-20",1); -- 返回2020-05-21,1表示加1天
select date_add("2020-05-20",-1); -- 返回2020-05-19，-1表示减一天

date_sub(DATE startdate, INT days)

解释

在startdate基础上减去几天，然后返回减去几天之后的一个日期,功能与date_add很类似

使用案例

select date_sub("2020-05-20",1); -- 返回2020-05-19,1表示减1天
select date_sub("2020-05-20",-1); -- 返回2020-05-21，-1表示加1天

date_format(DATE|TIMESTAMP|STRING ts, STRING fmt)

解释

将date/timestamp/string类型的值转换为一个具体格式化的字符串。支持java的SimpleDateFormat格式，第二个参数fmt必须是一个常量

使用案例

select date_format('2020-05-20', 'yyyy'); -- 返回2020
select date_format('2020-05-20', 'MM'); -- 返回05
select date_format('2020-05-20', 'dd'); -- 返回20
-- 返回2020年05月20日 00时00分00秒
select date_format('2020-05-20', 'yyyy年MM月dd日 HH时mm分ss秒') ;
select date_format('2020-05-20', 'yy/MM/dd') -- 返回 20/05/20

dayofmonth(STRING date)

解释

返回一个日期或时间的天,与day()函数功能相同

使用案例

select dayofmonth('2020-05-20') -- 返回20

extract(field FROM source) 时间截取函数

解释

提取 day, dayofweek, hour, minute, month, quarter, second, week 或者year的值，field可以选择day, dayofweek, hour, minute, month, quarter, second, week 或者year，source必须是一个date、timestamp或者可以转为 date 、timestamp的字符串。注意：Hive 2.2.0版本之后支持该函数

使用案例

select extract(year from '2020-05-20 15:21:34.467'); -- 返回2020，年
select extract(quarter from '2020-05-20 15:21:34.467'); -- 返回2，季度
select extract(month from '2020-05-20 15:21:34.467'); -- 返回05，月份
select extract(week from '2020-05-20 15:21:34.467'); -- 返回21，同weekofyear，一年中的第几周
select extract(dayofweek from '2020-05-20 15:21:34.467'); -- 返回4,代表星期三
select extract(day from '2020-05-20 15:21:34.467'); -- 返回20，天
select extract(hour from '2020-05-20 15:21:34.467'); -- 返回15，小时
select extract(minute from '2020-05-20 15:21:34.467'); -- 返回21，分钟
select extract(second from '2020-05-20 15:21:34.467'); -- 返回34，秒

year(STRING date)

解释

返回时间的年份,可以用extract函数替代

使用案例

select year('2020-05-20 15:21:34'); -- 返回2020

quarter(DATE|TIMESTAMP|STRING a)

解释

返回给定时间或日期的季度，1至4个季度,可以用extract函数替代

使用案例

select quarter('2020-05-20 15:21:34'); -- 返回2，第2季度

month(STRING date)

解释

返回时间的月份,可以用extract函数替代

使用案例

select month('2020-05-20 15:21:34') -- 返回5

day(STRING date),

解释

返回一个日期或者时间的天,可以用extract函数替代

使用案例

select day("2020-05-20"); -- 返回20
select day("2020-05-20 15:05:27.5"); -- 返回20

hour(STRING date)

解释

返回一个时间的小时,可以用extract函数替代

使用案例

select hour('2020-05-20 15:21:34');-- 返回15

minute(STRING date)

解释

返回一个时间的分钟值,可以用extract函数替代

使用案例

select minute('2020-05-20 15:21:34'); -- 返回21

second(STRING date)

解释

返回一个时间的秒,可以用extract函数替代

使用案例

select second('2020-05-20 15:21:34'); --返回34

from_unixtime(BIGINT unixtime [, STRING format])

解释

将将Unix时间戳转换为字符串格式的时间(比如yyyy-MM-dd HH:mm:ss格式)

使用案例

select from_unixtime(1589960708); -- 返回2020-05-20 15:45:08
select from_unixtime(1589960708, 'yyyy-MM-dd hh:mm:ss'); -- -- 返回2020-05-20 15:45:08
select from_unixtime(1589960708, 'yyyy-MM-dd'); -- 返回2020-05-20

from_utc_timestamp(T a, STRING timezone)

解释

转换为特定时区的时间

使用案例

select from_utc_timestamp('2020-05-20 15:21:34','PST'); -- 返回2020-05-20 08:21:34.0
select from_utc_timestamp('2020-05-20 15:21:34','GMT'); -- 返回2020-05-20 15:21:34.0
select from_utc_timestamp('2020-05-20 15:21:34','UTC'); -- 返回2020-05-20 15:21:34.0
select from_utc_timestamp('2020-05-20 15:21:34','DST'); -- 返回2020-05-20 15:21:34.0
select from_utc_timestamp('2020-05-20 15:21:34','CST'); -- 返回2020-05-20 10:21:34.0

last_day(STRING date)

解释

返回给定时间或日期所在月的最后一天，参数可以是’yyyy-MM-dd HH:mm:ss’ 或者 ‘yyyy-MM-dd’类型，时间部分会被忽略

使用案例

select last_day('2020-05-20 15:21:34'); -- 返回2020-05-31
select last_day('2020-05-20'); -- 返回2020-05-31

to_date(STRING timestamp)

解释

返回一个字符串时间的日期部分，去掉时间部分，2.1.0之前版本返回的是string，2.1.0版本及之后返回的是date

使用案例

select to_date('2020-05-20 15:21:34'); -- 返回2020-05-20
select to_date('2020-05-20'); -- 返回2020-05-20

to_utc_timestamp(T a, STRING timezone)

解释

转换为世界标准时间UTC的时间戳,与from_utc_timestamp类似

使用案例

select to_utc_timestamp('2020-05-20 15:21:34', 'GMT'); -- 返回2020-05-20 15:21:34.0

trunc(STRING date, STRING format) 截取年或月的第一天

解释

截断日期到指定的日期精度，仅支持月（MONTH/MON/MM）或者年（YEAR/YYYY/YY）

使用案例

select trunc('2020-05-20', 'YY');   -- 返回2020-01-01，返回年的1月1日
select trunc('2020-05-20', 'MM');   -- 返回2020-05-01，返回月的第一天
select trunc('2020-05-20 15:21:34', 'MM');   -- 返回2020-05-01

unix_timestamp([STRING date [, STRING pattern]])

解释

参数时可选的，当参数为空时，返回当前Unix是时间戳，精确到秒。可以指定一个具体的日期，转换为Unix时间戳格式

使用案例

-- 返回1589959294
select unix_timestamp('2020-05-20 15:21:34','yyyy-MM-dd hh:mm:ss');
-- 返回1589904000
select unix_timestamp('2020-05-20','yyyy-MM-dd');

weekofyear(STRING date)

解释

返回一个日期或时间在一年中的第几周，可以用extract替代

使用案例

select weekofyear('2020-05-20 15:21:34'); -- 返回21，第21周
select weekofyear('2020-05-20'); -- 返回21，第21周

next_day(STRING start_date, STRING day_of_week)

解释

参数start_date可以是一个时间或日期，day_of_week表示星期几，比如Mo表示星期一，Tu表示星期二，Wed表示星期三，Thur表示星期四，Fri表示星期五，Sat表示星期六，Sun表示星期日。如果指定的星期几在该日期所在的周且在该日期之后，则返回当周的星期几日期，如果指定的星期几不在该日期所在的周，则返回下一个星期几对应的日期

使用案例

select next_day('2020-05-20','Mon');-- 返回当前日期的下一个周一日期:2020-05-25
select next_day('2020-05-20','Tu');-- 返回当前日期的下一个周二日期:2020-05-26
select next_day('2020-05-20','Wed');-- 返回当前日期的下一个周三日期:2020-05-27
-- 2020-05-20为周三，指定的参数为周四，所以返回当周的周四就是2020-05-21
select next_day('2020-05-20','Th');
select next_day('2020-05-20','Fri');-- 返回周五日期2020-05-22
select next_day('2020-05-20','Sat'); -- 返回周六日期2020-05-23
select next_day('2020-05-20','Sun'); -- 返回周六日期2020-05-24

该函数比较重要：比如取当前日期所在的周一和周日，通过长用在按周进行汇总数据

select date_add(next_day('2020-05-20','MO'),-7); -- 返回当前日期的周一日期2020-05-18
select date_add(next_day('2020-05-20','MO'),-1); -- 返回当前日期的周日日期2020-05-24

months_between(DATE|TIMESTAMP|STRING date1, DATE|TIMESTAMP|STRING date2)

解释

返回 date1 和 date2 的月份差。如果date1大于date2，返回正值，否则返回负值，如果是相减是整数月，则返回一个整数，否则会返回小数

使用案例

select months_between('2020-05-20','2020-05-20'); -- 返回0
select months_between('2020-05-20','2020-06-20'); -- 返回-1
-- 相差的整数月
select months_between('2020-06-30','2020-05-31'); -- 返回1
-- 非整数月，一个月差一天
select months_between('2020-06-29','2020-05-31'); -- 返回0.93548387

条件函数#

assert_true(BOOLEAN condition)#

coalesce(T v1, T v2, &mldr;)#

if#

isnotnull(a)#

isnull(a)#

nullif(a, b)#

nvl(T value, T default_value)#

日期函数#

add_months#

current_date#

current_timestamp()#

datediff(STRING enddate, STRING startdate)#

date_add(DATE startdate, INT days)#

date_sub(DATE startdate, INT days)#

date_format(DATE|TIMESTAMP|STRING ts, STRING fmt)#

dayofmonth(STRING date)#

extract(field FROM source) 时间截取函数#

year(STRING date)#

quarter(DATE|TIMESTAMP|STRING a)#

month(STRING date)#

day(STRING date),#

hour(STRING date)#

minute(STRING date)#

second(STRING date)#

from_unixtime(BIGINT unixtime [, STRING format])#

from_utc_timestamp(T a, STRING timezone)#

last_day(STRING date)#

to_date(STRING timestamp)#

to_utc_timestamp(T a, STRING timezone)#

trunc(STRING date, STRING format) 截取年或月的第一天#

unix_timestamp([STRING date [, STRING pattern]])#

weekofyear(STRING date)#

next_day(STRING start_date, STRING day_of_week)#

months_between(DATE|TIMESTAMP|STRING date1, DATE|TIMESTAMP|STRING date2)#