跳转至主要内容

处理日期和时间

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

输出:

t1t2
2022-05-16 00:00:00.0002022-05-16 04:00:00.000

format_datetime

format_datetime(time,format,timezone) 将日期时间的格式化为字符串。 第三个参数是可选的。 支持以下占位符

占位符描述输出字符串
%Y四位数年份2022
%y2位数年份22
%m月份带2位数字01
%d含2位数字的日02
%F短的 YYYY-MM-DD 日期,相当于 %Y-%m-%d2022-01-02
%DMM/DD/YY 短日期,相当于 %m/%d/%y01/02/22
%H小时带有2位数字 (00-23)13
%M2位数分钟(00-59)44
%S2位数秒(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 使用。 检查 time1time2 之间的差距是否在特定范围内。 例如 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() 的简写方式