跳转至主要内容

处理日期和时间

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 函数。

小时​

请参阅 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 使用。 检查 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() 的简写方式

最后 由 Jove Zhong 于 更新