云日志服务提供时间函数、日期函数、日期和时间提取函数、日期和时间格式转换函数等，支持对日志中的日期和时间进行格式转换等处理。本文介绍日期和时间函数的语法及示例。
函数列表
| 函数名称 | 语法 | 说明 |
|---|---|---|
| current_date函数 | current_date() | 返回当前日期。同curdate函数。 |
| curdate函数 | curdate() | 返回当前日期。同current_date函数。 |
| current_timestamp函数 | current_timestamp() | 返回当前时间。同now函数 |
| toDateTime函数 | toDateTime(expr, tz) | 将日期和时间表达式转换为datetime类型。 |
| now函数 | now() | 返回当前时间。同current_timestamp |
| current_timezone函数 | current_timezone() | 返回当前时区。 |
| date函数 | date(expr) | 返回日期和时间表达式中的日期部分。 |
| date_format函数 | date_format(x, format) | 将datetime类型的日期和时间表达式转化为指定格式的日期和时间表达式。 |
| tostartofinterval函数 | tostartofinterval(x, INTERVAL n interval) | 返回指定时间间隔的开始时间 |
| from_unixtime函数 | from_unixtime(x) | 将UNIX时间戳转化为datetime类型的日期和时间表达式。 |
| unix_timestamp函数 | unix_timestamp(x) | 将日期和时间表达式转化成UNIX时间戳。 |
| day函数 | day(x) | 提取日期和时间表达式中的天数，按月计算。同dayofmonth函数。 |
| dayofmonth函数 | dayofmonth(x) | 提取日期和时间表达式中的天数，按月计算。同day函数。 |
| dayofweek函数 | dayofweek(x) | 返回日期和时间表达式的周索引。同weekday函数。 |
| weekday函数 | weekday(x) | 返回日期和时间表达式的周索引。同dayofweek函数。 |
| dayofyear函数 | dayofyear(x) | 提取日期和时间表达式中的天数，按年计算。 |
| tohour函数 | tohour(x) | 提取时间表达式的24小时制（0-23）小时数。同hour函数。 |
| minute函数 | minute(x) | 提取日期和时间表达式中的分钟数。 |
| month函数 | month(x) | 提取日期和时间表达式中的月份。 |
| quarter函数 | quarter(x) | 计算目标日期所属的季度。 |
| hour函数 | hour(x) | 提取日期和时间表达式中的小时数，按24小时制计算。同tohour函数。 |
| second函数 | second(x) | 提取日期和时间表达式中的秒数。 |
| week函数 | week(x) | 计算目标日期是在一年中的第几周。同weekofyear函数。 |
| weekofyear函数 | weekofyear(x) | 计算目标日期是在一年中的第几周。同week函数。 |
| year函数 | year(x) | 提取目标日期中的年份。 |
| date_trunc函数 | date_trunc(unit, x) | 根据指定的时间单位截断日期和时间表达式，并按照毫秒、秒、分钟，小时、日、月或年对齐。 |
| date_add函数 | date_add(x, INTERVAL n interval) | 在x上加上N个时间单位（interval）。同adddate函数。 |
| adddate函数 | adddate(x, INTERVAL n interval) | 在x上加上N天。同date_add函数。 |
| convert_tz函数 | convert_tz(x, tz) | 将指定日期时间表达式从一个时区转换为另一个时区，并返回新的日期时间表达式 |
| date_sub函数 | date_sub(date, INTERVAL n interval) | 在x上减去N个时间单位（interval）。同subdate函数。 |
| subdate函数 | subdate(date, INTERVAL n interval) | 在x上减去N个时间单位（interval）。同date_sub函数。 |
| localtime函数 | localtime() | 返回本地时间。同localtimestamp函数。 |
| localtimestamp函数 | localtimestamp() | 返回本地日期和时间。同localtime函数。 |
| makedate函数 | makedate(year, month, day)makedate(x, day_of_year) | 根据参数生成日期。 |
| monthname函数 | monthname(x) | 将日期时间表达式转换为月份名称。 |
current_date函数
返回当前日期。同curdate函数。
语法
current_date()
参数说明
无
返回值类型
日期类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT current_date() |
| 返回结果 |
2024-03-01 |
current_timestamp函数
返回当前时间。同now函数。
语法
current_date()
参数说明
无
返回值类型
datetime类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT current_timestamp() |
| 返回结果 |
2024-03-01 15:32:36 |
toDateTime函数
将日期和时间表达式转换为datetime类型。
语法
toDateTime(expr, tz)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| expr | 如果参数为string类型，则当做日期和时间表达式来解析；如果参数为integer类型，则当做单位为秒的Unix时间戳。 | string类型或integer类型 | 是 |
| tz | 时区表达式 | string类型 | 否 |
返回值类型
datetime类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT toDateTime(1709253000, 'Asia/Shanghai') |
| 返回结果 |
2024-03-01 08:30:00 |
current_timezone函数
返回当前时区。
语法
current_timezone()
参数说明
无
返回值类型
string类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT current_timezone() |
| 返回结果 |
Asia/Shanghai |
date函数
返回日期和时间表达式中的日期部分。
语法
date(expr)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| expr | 如果参数为string类型，则当做日期和时间表达式来解析；如果参数为integer类型，则表示从1970-01-01开始的日期偏移量。 | string类型或integer类型 | 是 |
返回值类型
日期类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT date(now()) |
| 返回结果 |
2024-03-01 |
date_format函数
将datetime类型的日期和时间表达式转化为指定格式的日期和时间表达式。
语法
date_format(x, format)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
| format |
日期和时间表达式的转换格式（见format说明） |
string类型 | 是 |
返回值类型
datetime类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT date_format(now(), '%H:%i:%S') |
| 返回结果 |
21:06:55 |
tostartofinterval函数
返回指定时间间隔的开始时间。
语法
tostartofinterval(x, INTERVAL n interval)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
| n | 时间间隔数量 |
integer类型 | 是 |
| interval |
时间间隔单位 |
见interval说明 | 是 |
返回值类型
日期和时间表达式
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT tostartofinterval(toDateTime('2023-09-01 21:06:33'), INTERVAL 1 hour) |
| 返回结果 |
2023-09-01 21:00:00 |
from_unixtime函数
将UNIX时间戳转化为datetime类型的日期和时间表达式。
语法
from_unixtime(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | UNIX时间戳 | integer类型 | 是 |
返回值类型
datetime类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT from_unixtime(1709253000) |
| 返回结果 |
2024-03-01 08:30:00 |
unix_timestamp函数
将日期和时间表达式转化成UNIX时间戳。
语法
unix_timestamp(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | 字符串或datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT unix_timestamp('2024-03-01 08:30:00') |
| 返回结果 |
1709253000 |
day函数
提取日期和时间表达式中的天数，按月计算。同dayofmonth函数。
语法
day(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT day('2024-02-28 08:30:00') |
| 返回结果 |
28 |
dayofweek函数
返回日期和时间表达式的周几。同weekday函数。
语法
dayofweek(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT dayofweek('2024-02-28 08:30:00') |
| 返回结果 |
3 |
dayofyear函数
提取日期和时间表达式中的天数，按年计算。
语法
dayofyear(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT dayofyear('2024-02-28 08:30:00') |
| 返回结果 |
59 |
tohour函数
提取时间表达式的24小时制（0-23）小时数。同hour函数。
语法
tohour(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECTtohour('2024-02-28 08:30:00') |
| 返回结果 |
8 |
minute函数
提取日期和时间表达式中的分钟数。
语法
minute(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT minute('2024-02-28 08:30:00') |
| 返回结果 |
30 |
month函数
提取日期和时间表达式中的月份。
语法
month(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT month('2024-02-28 08:30:00') |
| 返回结果 |
2 |
quarter函数
计算目标日期所属的季度。
语法
quarter(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT quarter('2024-02-28 08:30:00') |
| 返回结果 |
1 |
second函数
提取日期和时间表达式中的秒数。
语法
second(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT second('2024-02-28 08:30:52') |
| 返回结果 |
52 |
week函数
计算目标日期是在一年中的第几周。同weekofyear函数。
语法
week(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT week('2024-02-28 08:30:52') |
| 返回结果 |
9 |
year函数
提取目标日期中的年份。
语法
year(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
integer类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT year('2024-02-28 08:30:52') |
| 返回结果 |
2024 |
date_trunc函数
根据指定的时间单位截断日期和时间表达式，并按照毫秒、秒、分钟，小时、日、月或年对齐。
语法
date_trunc(unit, x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| unit | 时间单位（见unit说明） | string类型 | 是 |
| x | 日期和时间表达式 | datetime类型 | 是 |
返回值类型
日期和时间表达式
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT date_trunc('quarter', toDateTime('2023-09-01 21:06:33')) |
| 返回结果 |
2023-07-01 00:00:00 |
date_add函数
在x上加上N个时间单位（interval）。同adddate函数。
语法
date_add(x, INTERVAL n interval)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
| n | 时间间隔数量 | integer | 是 |
| interval | 时间间隔单位 | 见Interval说明 | 是 |
返回值类型
日期和时间表达式
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT date_add(toDateTime('2023-09-01 21:06:33'), INTERVAL 1 month) |
| 返回结果 |
2023-10-01 21:06:33 |
convert_tz函数
将指定日期时间表达式从一个时区转换为另一个时区，并返回新的日期时间表达式。
语法
convert_tz(x, tz)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
| tz | 时区 | string类型 | 是 |
返回值类型
日期和时间表达式
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT convert_tz(toDateTime('2023-09-01 21:06:33'), 'UTC') |
| 返回结果 |
2023-09-01 13:06:33 |
date_sub函数
在x上减去N个时间单位（interval）。同subdate函数。
语法
date_sub(x, INTERVAL n interval)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | datetime类型 | 是 |
| n | 时间间隔数量 | integer | 是 |
| interval | 时间间隔单位 | 见Interval说明 | 是 |
返回值类型
日期和时间表达式
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT date_sub(toDateTime('2023-09-01 21:06:33'), INTERVAL 1 month) |
| 返回结果 |
2023-08-01 21:06:33 |
localtime函数
返回本地时间。同localtimestamp函数。
语法
localtime()
参数说明
无
返回值类型
日期类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT localtime() |
| 返回结果 |
2023-09-01 19:16:25 |
makedate函数
根据参数生成日期。
语法
makedate(year, month, day)
makedate(x, day_of_year)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| year | 年份 | string或integer类型 | 是 |
| month | 月份（1-12） | string或integer类型 | 是 |
| day | 天（1-31） | string或integer类型 | 是 |
| day_of_year | 每年的第几天 | string或integer类型 | 是 |
返回值类型
日期表达式
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT makedate(2024, 60) |
| 返回结果 |
2024-02-29 |
monthname函数
将日期时间表达式转换为月份名称。
语法
monthname(x)
参数说明
| 参数名称 | 说明 | 类型 | 是否必选 |
|---|---|---|---|
| x | 日期和时间表达式 | string类型 | 是 |
返回值类型
string类型
示例
| 类型 |
示例 |
|---|---|
| 统计分析语句 |
SELECT monthname('2023-09-01 21:06:33') |
| 返回结果 |
September |
format说明
| 占位符 |
说明 | 样例 |
|---|---|---|
| %a | 星期的英文缩写 (Mon-Sun) | Fri |
| %b | 月份的英文缩写 (Jan-Dec) | Sep |
| %c | 月份 (01-12) | 09 |
| %C | 年份后两位 (00-99) | 23 |
| %d | 每月的第几天。1位数的前面补0 (01-31) | 01 |
| %e | 每月的第几天。前面不补0 (1-31) | 1 |
| %h | 小时，12小时制 (01-12) | 10 |
| %H | 小时，24小时制 (00-23) | 22 |
| %i | 分钟 (00-59) | 30 |
| %j | 每年的第几天 (001-366) | 003 |
| %k | 小时，24小时制 (00-23) | 22 |
| %l | 小时，12小时制 (01-12) | 10 |
| %m | 月份 (01-12) | 09 |
| %M | 月份的英文全称 (January-December) | September |
| %p | AM/PM | PM |
| %Q | 每年的第几季度 (1-4) | 3 |
| %r | 时间。12小时制，格式为hh:mm AM/PM。相当于%h:%i %p | 10:30 PM |
| %R | 时间。24小时制，格式为HH:MM。相当于%H:%i | 22:30 |
| %s | 秒 (00-59) | 32 |
| %S | 秒 (00-59) | 32 |
| %T | 时间。ISO 8601格式(HH:MM:SS)，相当于%H:%i:%S | 22:30:32 |
| %u | 每周的第几天，从周一开始 (1-7) | 2 |
| %V | 每年的第几周 (01-53) | 01 |
| %w | 每周的第几天，从周日开始 (0-6) | 2 |
| %W | 星期的英文全称 (Monday-Sunday) | Monday |
| %y | 年份后两位 (00-99) | 23 |
| %Y | 年份，4位数 | 2023 |
| %z | 相较UTC的时钟偏移 +HHMM 或 -HHMM | +0800 |
| %% | %的转义字符 | % |
unit说明
| unit | 说明 |
|---|---|
| year | 年 |
| quarter | 季度 |
| month | 月 |
| week | 周 |
| day | 天 |
| hour | 小时 |
| minute | 分钟 |
| second | 秒 |
interval说明
| interval | 说明 |
|---|---|
| year | 年 |
| quarter | 季度 |
| month | 月 |
| week | 周 |
| day | 天 |
| hour | 小时 |
| minute | 分钟 |
| second | 秒 |
| millisecond | 毫秒 |
| microsecond |
微秒 |
