TDSQL Boundless 日期函数支持说明

二、DATEDIFF 函数

返回两个日期之间相差的天数。

语法：DATEDIFF(date1, date2)

·date1支持的数据类型：date、datetime。

·date2支持的数据类型：date、datetime。

三、YEAR 函数

返回日期的年份。

语法：YEAR(date1)

date1支持的数据类型：date、datetime、char、varchar。

四、MONTH 函数

返回日期的月份。

语法：MONTH(date1)

date1支持的数据类型：date、datetime、char、varchar。

五、DAY 函数

返回日期是当月的第几天。

语法：DAY(date1)

date1支持的数据类型：date、datetime、char、varchar。

六、HOUR 函数

返回时间的小时部分。

语法：HOUR(date1)

date1支持的数据类型：date、datetime。

七、MINUTE 函数

返回时间的分钟部分。

语法：MINUTE(date1)

date1支持的数据类型：date、datetime。

八、SECOND 函数

返回时间的秒部分。

语法：SECOND(date1)

date1支持的数据类型：date、datetime。

九、MICROSECOND 函数

返回时间或日期时间的微秒部分。

语法：MICROSECOND(date1)

date1支持的数据类型：date、datetime。

十、QUARTER 函数

返回给定日期所在的季度（1到4之间的数字）。

语法：QUARTER(date1)

date1支持的数据类型：date、datetime、char、varchar。

十一、DATE 函数

提取日期或日期时间表达式的日期部分。

语法：DATE(date1)

date1支持的数据类型：date、datetime、char、varchar。

十二、SYSDATE 函数

返回系统当前的日期和时间。

语法：SYSDATE()

无需入参。

十三、DATE_ADD 函数

将指定的时间间隔加到日期上。

语法：DATE_ADD(date1, INTERVAL expr type)

·date1 支持的数据类型：date、datetime。

·expr 支持的数据类型：int、bigint、double、decimal。

·type 支持取值：DAY（关键字）。

十四、DATE_SUB 函数

从日期中减去指定的时间间隔。

语法：DATE_SUB(date1, INTERVAL expr type)

·date1 支持的数据类型：date、datetime。

·expr 支持的数据类型：int、bigint、double、decimal。

·type 支持取值：DAY（关键字）。

十五、DAYOFYEAR 函数

返回给定日期是当年的第几天。

语法：DAYOFYEAR(date1)

date1支持的数据类型：date、datetime、char、varchar。

十六、DAYOFMONTH 函数

返回给定日期是当月的第几天。

语法：DAYOFMONTH(date1)

date1支持的数据类型：date、datetime、char、varchar。

十七、DAYOFWEEK 函数

返回给定日期是当周的第几天。

语法：DAYOFWEEK(date1)

date1支持的数据类型：date、datetime、char、varchar。

十八、DAYNAME 函数

返回指定日期对应的星期名称。

语法：DAYNAME(date1)

date1支持的数据类型：date、datetime、char、varchar。

十九、MONTHNAME 函数

返回指定日期对应的月份名称。

语法：MONTHNAME(date1)

date1支持的数据类型：date、datetime、char、varchar。

20、TO_SECONDS 函数

返回指定的日期或日期时间从公元0年开始的秒数。

语法：TO_SECONDS(date1)

date1支持的数据类型：date、datetime、char、varchar。

21、LAST_DAY 函数

返回给定日期所在月份的最后一天。

语法：LAST_DAY(date1)

date1支持的数据类型：date、datetime、char、varchar。

22、SLEEP 函数

在执行时暂停指定的秒数。

语法：SLEEP(N)

N 支持的数据类型：int。

23、NOW 函数

返回当前的日期和时间。

语法：NOW()

无需入参。

24、CURRENT_TIMESTAMP 函数

返回当前的日期和时间，等价于 NOW()。

语法：CURRENT_TIMESTAMP()

无需入参。

25、CURDATE 函数

返回当前日期，等价于 CURRENT_DATE()。

语法：CURDATE()

无需入参。

26、CURRENT_DATE 函数

返回当前日期，等价于 CURDATE()。

语法：CURRENT_DATE()

无需入参。

27、CURRENT_TIME 函数

返回当前时间。

语法：CURRENT_TIME()

无需入参。

28、CURTIME 函数

返回当前时间，等价于 CURRENT_TIME()。

语法：CURTIME()

无需入参。

29、FROM_UNIXTIME 函数

将 Unix 时间戳转换为指定格式的日期时间字符串。

语法：FROM_UNIXTIME(unix_timestamp [, format])

·unix_timestamp 支持的数据类型：int。

·format 可选，支持的格式参见 DATE_FORMAT 函数 的格式表。若 format 为空，则默认使用 %Y-%m-%d %H:%i:%s 格式。

30、UNIX_TIMESTAMP 函数

将日期时间转换为 Unix 时间戳。

语法：UNIX_TIMESTAMP([date])

date 支持的数据类型：标准的 DATE 类型。

31、WEEKDAY 函数

返回给定日期对应的星期数。

语法：WEEKDAY(date)

·入参支持的数据类型：date、datetime。

·返回结果范围为0 – 6，分别对应星期一至星期日。

·如果日期为 NULL 或 0000-00-00，函数返回 NULL。

32、TIMEDIFF 函数

返回两个时间之间的差值。

语法：TIMEDIFF(time1, time2)

返回 time1 – time2 的时间差值。

33、TO_DAYS 函数

返回从公元0年12月31日到给定日期的天数。

语法：TO_DAYS(date)

·date 支持的数据类型：date 或字符串。

·返回值类型为数字。

34、YEARWEEK 函数

返回指定日期所在的年份和周数。

语法：YEARWEEK(date [, mode])

·date：要计算的日期，例如 '2025-06-15'。

·mode：可选参数，用于指定周的起始日。默认为0，表示周的起始日为周日。

·返回值类型为数字。

35、TIME 函数

提取日期时间表达式中的时间部分，并以字符串形式返回。

语法：TIME(expr)

·expr 支持的数据类型：时间类型或日期时间类型。

·返回值类型为字符串。如果 expr 为 NULL，则返回 NULL。

36、DATE_FORMAT 函数

按指定格式格式化日期。

语法：DATE_FORMAT(date1, format)

·date1支持的数据类型：date、datetime、char、varchar，不支持 date1 为 NULL 的场景。

·format：日期/时间的输出格式，支持的格式说明符如下表。