处理日期和时间
year
使用 year(date)
来获取当前年份,例如 year(today())
将返回当前年份。
quarter
使用 quarter(date)
获取当前季度,例如 quarter(today())
将是 1
,如果现在是Q1的话。
month
使用 month(date)
获取月份,例如 month(today())
将会是 2
,如果现在是二月的话。
day
使用 day(date)
来获取当月的日期。
day_of_year
使用 day_of_year(date)
来获取这一天在该年中的天数(1-365,或闰年的1-366)。
day_of_week
使用day_of_week(date)
来获取周中的某一天。 例如,星期一是 1,星期日是 7。
hour
使用 hour(datetime)
获取日期时间中的小时。
minute
使用 minute(datetime)
获取日期时间中的分钟。
second
使用 second(datetime)
获取日期时间中的秒。
to_unix_timestamp
返回日期时间的 UNIX 时间戳,一个数字在 uint32
例如, to_unix_timestamp(now())
返回 1644272032
to_unix_timestamp64_milli
返回以 datetime64 毫秒为单位的 UNIX 时间戳,该数字位于 int64
例如 to_unix_timestamp64_milli (now64 ())
返回 1712982826540
to_unix_timestamp64_micro
返回以 datetime64 的微秒为单位的 UNIX 时间戳,该数字位于 int64
例如 to_unix_timestamp64_micro (now64 (9))
返回 1712982905267202
to_unix_timestamp64_nano
返回带有 datetime64 纳秒的 UNIX 时间戳,该数字位于 int64
例如 to_unix_timestamp64_nano (now64 (9))
返回 1712983042242306000
to_start_of_year
to_start_of_year(date)
将日期或带时间的日期倒退到一年的第一天。 返回日期。
to_start_of_quarter
to_start_of_quarter(date)
将日期或带有时间的日期倒退到季度的第一天。 返回日期。
to_start_of_month
to_start_of_month(date)
将日期或带有时间的日期返回到该月的第一天。 返回日期。
to_start_of_week
to_start_of_week(date)
将日期或带时间的日期倒退到一周的第一天。 返回日期。
to_start_of_day
to_start_of_day(date)
将日期或带时间的日期倒退到该天的开始。
to_start_of_hour
to_start_of_hour(datetime)
将日期或带时间的日期倒退到该小时的最开始。
to_start_of_minute
to_start_of_minute(datetime)
将日期或带时间的日期倒退到那一分钟的最开始。
to_start_of_second
to_start_of_second (datetime64)
将日期或带有时间的日期倒退回那一秒的开始。
不同于其他 to_start_of_
函数,这个函数需要一个有毫秒的日期时间,例如 to_start_of_second(now64())
to_date
to_date(string)
将日期字符串转换为日期类型,例如 to_date('1953-11-02')
它可以解析字符串 2023-09-19 05:31:34
但不能 2023-09-19T 05:31:34 Z
。 请使用 to_time 函数。
to_datetime
to_datetime(value)
将值转换为日期时间类型,例如 to_datetime(1655265661)
或 to_datetime(today())
它可以解析字符串 2023-09-19 05:31:34
但不能 2023-09-19T 05:31:34 Z
。 请使用 to_time 函数。
小时
Please refer to to_time
today
to_YYYYMMDDhhmmss(date)
返回一个数字。
to_YYYYMM
to_YYYYMM(date)
返回一个数字。 例如, o_YYYYMM(today())
将返回数字 202202
to_YYYYMMDD
to_YYYYMMDD(date)
返回一个数字。
to_YYYMMDDhmmss
today ()
返回当前日期。
to_timezone
to_timezone(datectime_in_a_timezone,target_timezone)
将日期时间从一个时区转换到另一个时区。
对于可能的时区的完整列表,请检查 维基百科页面 中的“TZ 数据库名称”栏。 对于最常见的时区,请查看 to _time
例如,
SELECT
to_time('2022-05-16', 'America/New_York') AS t1, to_timezone(t1, 'UTC') AS t2
输出:
t1 | t2 |
---|---|
2022-05-16 00:00:00.000 | 2022-05-16 04:00:00.000 |
format_datetime
format_datetime(time,format,timezone)
将 日期时间的格式化为字符串。 第三个参数是可选的。 支持以下占位符
占位符 | 描述 | 输出字符串 |
---|---|---|
%Y | 四位数年份 | 2022 |
%y | 2位数年份 | 22 |
%m | 月份带2位数字 | 01 |
%d | 含2位数字的日 | 02 |
%F | 短的 YYYY-MM-DD 日期,相当于 %Y-%m-%d | 2022-01-02 |
%D | MM/DD/YY 短日期,相当于 %m/%d/%y | 01/02/22 |
%H | 小时带有2位数字 (00-23) | 13 |
%M | 2位数分钟(00-59) | 44 |
%S | 2位数秒(00-59) | 44 |
%w | 周日为小数点,周日为0(0-6) | 1 |
parse_datetime
将字符串转换为日期时间。 此函数与函数 format_datetime的运算相反。
parse_datetime (str, format [, 时区])
. 例如 select parse_datetime ('2021-01-04+ 23:00:00 ','%Y-%m-%d+%H:%i:%s')
返回 '2021-01-04 23:00:00'。
parse_datetime_in_joda_syntax
与 parse_datetime类似,不同之处在于格式字符串采用 Joda 而不是 MySQL 语法。
parse_datetime_in_joda_syntax (str,格式 [,时区])
. 例如 select parse_datetime_in_joda_syntax ('2023-02-24 14:53:31 ','yyyy-MM-DD HH: mm: ss')
返回 '2023-02-24 14:53:31'。
date_diff
例如: date_diff('second',window_start,window_end)
date_diff(unit,begin,end)
计算 开始
和 结束
之间的差额,并在 unit
中生成一个数字。
支持的单位:
- us:表示微秒。 1 秒 = 1,000,000 微秒
- ms:表示毫秒。 1 秒 = 1,000 毫秒
- s︰表示秒数
- m:表示分钟
- h:表示小时
- d:表示天数
date_diff_within
date_diff_within(timegap,time1, time2)
返回 true 或 false。 此函数只能在 stream-to-stream join 使用。 检查 time1
和 time2
之间的差距是否在特定范围内。 例如 date_diff_within(10s,payment.time,notification.time)
来检查付款时间和通知时间是否在10秒或更短。
date_trunc
date_trunc(funit), value[, timezone])
将日期和时间数据截断到日期的指定部分。 例如, date_trunc('month',now())
返回的是当前月的月初的日期时间。 可能的单位值为:
- 年
- 季度
- 月
- 天
- 小时
- 分钟
- 秒
date_add
它支持 date_add(unit, value, date)
和快捷解决 data_add(date,timeExpression)
date_add(HOUR, 2, now())
将在 2 小时内获得一个新的日期时间。date_add(HOUR, -2, now())
将得到一个新的日期时间 2 小时后退。date_add(now(),2h)
和date_add(now(),-2h)
也工作
date_sub
它支持 date_sub(unit, value, date)
和快捷解决 data_sub(date,timeExpression)
date_sub(HOUR, 2, now())
将获得一个新的日期时间 2 小时date_sub (now () ,2h)
也起作用
earliest_timestamp
earest_timestamp()
返回 "1970-1-1 00:00:00"
earliest_ts
earliest_ts()
是 earliest_timestamp()
的简写方式