华为云用户手册

yow函数 返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。 语法：yow(expr) 表60 参数说明 参数名称 描述 类型 是否必选 expr 时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS或yyyy-MM-dd String 是 返回值类型：Integer类型 示例：SELECT YOW('2023-09-22 14:47:59.325'), YOW('2023-09-22') 表61 查询分析结果 类型 场景1 场景2 查询语句 YOW('2023-09-22 14:47:59.325') YOW('2023-09-22') 返回结果 2023 2023 表62 参数说明 参数名称 描述 类型 是否必选 expr 时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS或yyyy-MM-dd String 是 返回值类型：Integer类型 示例：SELECT YOW(from_unixtime(__time)) 表63 查询分析结果 类型 场景 查询语句 YOW(from_unixtime(__time)) 返回结果 2024

time_series函数 用于补全您查询时间窗口内缺失的数据。time_series函数必须搭配GROUP BY语法和ORDER BY语法使用。 语法：time_series(x, window_time, format, padding_data) 表64 参数说明 参数名称 描述 类型 是否必选 x 原始字段。 long或timestamap 是 window_time 窗口大小，单位为s（秒）、m（分）、h（小时）、d（天）。例如2h、5m、3d。 String 是 format 返回结果的时间格式。 String 是 padding_data 补全的内容。包括：0：将缺失的值设置为0。null：将缺失的值设置为null。last：将缺失的值设置了上一个时间点对应的值。next：将缺失的值设置了下一个时间点对应的值。avg：将缺失的值设置为前后两个时间点的平均值。 String 是 返回值类型：String 示例：select time_series(__time, '1d', 'HH:mm:ss','0') as time, count(*) as count group by time order by time asc 表65 查询分析结果 类型 场景 查询语句 select time_series(__time, '1m', 'HH:mm:ss','0') as time, count(*) as count group by time order by time asc 返回结果 time count 7:04:00 5.00 7:05:00 6.00 7:06:00 6.00 7:07:00 6.00 7:08:00 6.00 7:09:00 6.00 7:10:00 6.00 7:11:00 6.00 7:12:00 6.00 7:13:00 6.00

year_of_week函数 返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。 语法：year_of_week(expr) 参数说明： 参数名称 描述 类型 是否必选 expr 时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS或yyyy-MM-dd String 是 返回值类型：Integer类型 示例：SELECT YEAR_OF_WEEK('2023-09-22 14:47:59.325'), YEAR_OF_WEEK('2023-09-22') 表58 查询分析结果 类型 场景1 场景2 查询语句 YEAR_OF_WEEK('2023-09-22 14:47:59.325') YEAR_OF_WEEK('2023-09-22') 返回结果 2023 2023 参数说明： 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 返回值类型：Integer 示例：SELECT YEAR_OF_WEEK(from_unixtime(__time)) 表59 查询分析结果 类型 场景 查询语句 YEAR_OF_WEEK(from_unixtime(__time)) 返回结果 2024

date_diff函数 返回时间戳expr1和时间戳expr2之间的单位数（有符号）。 语法：date_diff(unit, expr1, expr2) 表48 参数说明 参数名称 描述 类型 是否必选 expr1 timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 expr2 timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp unit 时间单位 String 是 返回值类型：Long类型 示例：SELECT DATE_DIFF('SECOND', CURRENT_TIMESTAMP() ,from_unixtime(__time)) 表49 查询分析结果 类型 场景 查询语句 DATE_DIFF('SECOND', CURRENT_TIMESTAMP() ,from_unixtime(__time)) 返回结果 -899.00

time_extract函数 通过指定字段提取日期时间表达式的日期或时间部分。EPOCH, SECOND, MINUTE, HOUR, DAY(月的日), DOW（周的日）, DOY（年的日）, WEEK（年周）, MONTH（1到12）, QUARTER（1到4）,或YEAR,时区（如果提供）应为时区名称，如"America/Los_Angeles"或偏移量，如"-08:00" 语法：time_extract(expr, unit) 表44 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS String 是 unit 时间单位 String 是 返回值类型：Long类型 示例：SELECT TIME_EXTRACT('2023-05-05','YEAR') 表45 查询分析结果 类型 场景 查询语句 TIME_EXTRACT('2023-05-05','YEAR') 返回结果 2023

date_trunc函数 根据您指定的时间单位截断日期和时间表达式，并以毫秒、秒、分钟、小时、天、月或年为单位对齐。 语法：date_trunc(unit, expr) 表46 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 unit 时间单位 String 是 返回值类型：Long类型 示例：SELECT DATE_TRUNC('year', from_unixtime(__time)) 表47 查询分析结果 类型 场景 查询语句 DATE_TRUNC('year', from_unixtime(__time)) 返回结果 2024-01-01 00:00:00.000 Asia/Shanghai

date_add函数 给时间加上给定的时间间隔。 语法：date_add(unit, n, expr) 表52 参数说明 参数名称 描述 类型 是否必选 unit 时间单位，取值为millisecond、second、minute、hour、day、week、month、quarter、year String 是 n 时间间隔 Long 是 expr timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 返回值类型：timestamp 示例：SELECT DATE_ADD('MINUTE', 7, from_unixtime(__time)) 表53 查询分析结果 类型 场景 查询语句 DATE_ADD('MINUTE', 7, from_unixtime(__time)) 返回结果 2024-11-18 23:23:47.407 Asia/Shanghai

timezone_minute函数 计算时区的分钟偏移量。 语法：timezone_minute(expr) 表34 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TIMEZONE timestamp 否 返回值类型：Integer类型 示例：SELECT TIMEZONE_MINUTE(from_unixtime(__time)) 表35 查询分析结果 类型 场景 查询语句 TIMEZONE_MINUTE(from_unixtime(__time)) 返回结果 0

date_format函数 timestamp类型的日期和时间表达式转换为指定日期和时间格式的字符串。 语法：date_format(expr, format) 表40 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 format 时间格式 String 是 返回值类型：String类型 示例：SELECT DATE_FORMAT(current_timestamp(),'%H%i') 表41 查询分析结果 类型 场景 查询语句 DATE_FORMAT(current_timestamp(),'%H%i') 返回结果 1432 format描述： %a Abbreviation for the week. For example, Sun and Sat. %b Abbreviation of the month. For example, Jan and Dec. %c Month. Numeral type. Range: 1-12. %D Day of the month. The value must be suffixed, for example, 0th, 1st, 2nd, and 3rd. %d Day of the month. The value ranges from 01 to 31 in decimal notation. %e Day of the month. The value ranges from 1 to 31 in decimal notation. %H Hour, 24-hour system. %h Hour, 12-hour system. %i Minute. Numeral type. Range: 00–59. %j Day of the year. The value ranges from 001 to 366. %k Hour. The value ranges from 0 to 23. %l Hour. The value ranges from 1 to 12. %M The English expression of the month, for example, January, December. %m Month. Numeral format. The value ranges from 01 to 12. %p AM and PM. %r Time in the 12-hour format. The format is hh:mm:ss AM/PM. %S Indicates the second. The value ranges from 00 to 59. %s Indicates the second. The value ranges from 00 to 59. %T Time, in the 24-hour format of hh:mm:ss. %v The first week of the year, Monday is the first day of the week. The value ranges from 01 to 53. %W The name of the day of the week. For example, Sunday and Saturday. %w Day of the week. Sunday is day 0. %Y A 4-digit year, for example, 2020. %y A 2-digit year, for example, 20. %% Escape character for%.

date_parse函数 将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。 语法：date_parse(expr, pattern) 表42 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式。 String 是 pattern 日期和时间表达式的转换格式 String 是 返回值类型：timestamp类型的日期和时间表达式。 示例：SELECT DATE_PARSE('2024-11-18 10:53','%Y-%m-%d %h:%i') 表43 查询分析结果 类型 场景 查询语句 DATE_PARSE('2024-11-18 10:53','%Y-%m-%d %h:%i') 返回结果 2024-11-18 18:53:00.000 pattern在设置时，如果设置了分钟，那么就必须同时配置分钟之前的年、月、日和时。

time_format函数 将毫秒级的时间戳或timestamp类型的日期和时间表达式expr，依据用户自定义的format参数以 Joda DateTimeFormat模式转换为指定日期和时间格式的字符串。 语法：time_format(expr, format) 表36 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式或毫秒级的时间戳 timestamp或Long 是 format 时间格式。 String 是 返回值类型：String类型 示例：SELECT TIME_FORMAT(__time, 'yyyy-MM-dd HH:mm:ss'), TIME_FORMAT(from_unixtime(__time), 'yyyy-MM-dd HH:mm:ss') 表37 查询分析结果 类型 场景1 场景2 查询语句 TIME_FORMAT(__time, 'yyyy-MM-dd HH:mm:ss') TIME_FORMAT(from_unixtime(__time), 'yyyy-MM-dd HH:mm:ss') 返回结果 2024-11-18 22:15:16 2024-11-18 22:15:16

floor函数 使用时间单位对时间戳进行向下舍入，单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。 语法：floor(expr, unit) 表28 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS timestamp 是 unit 时间单位 String 是 返回值类型：Strin类型 示例：SELECT FLOOR('2023-04-20 11:28:31.770', 'DAY') 表29 查询分析结果 类型 场景 查询语句 FLOOR('2023-04-20 11:28:31.770', 'DAY') 返回结果 2023-04-20 00:00:00.000

timezone_hour函数 计算时区的小时偏移量。 语法：timezone_hour(expr) 表32 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TIMEZONE timestamp 否 返回值类型：Integer类型 示例：SELECT TIMEZONE_HOUR(from_unixtime(__time)) 表33 查询分析结果 类型 场景 查询语句 SELECT TIMEZONE_HOUR(from_unixtime(__time)) 返回结果 8

time_shift函数 将时间戳expr移动一个Period（步长时间）。Period可以是任何ISO8601的Period。 语法：time_shift(expr, period, step, [timezone]) 表30 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 period ISO8601的周期 String 是 step 步长 Integer 是 timezone 时区 String 否 返回值类型：String类型 示例：SELECT TIME_SHIFT( from_unixtime(__time), 'P1D', 5), TIME_SHIFT( from_unixtime(__time), 'P1D', 5,'+08:00') 表31 查询分析结果 类型 场景1 场景2 查询语句 TIME_SHIFT( from_unixtime(__time), 'P1D', 5) TIME_SHIFT( from_unixtime(__time), 'P1D', 5,'+08:00') 返回结果 2024-11-23 21:58:59.907 Asia/Shanghai 2024-11-23 21:58:59.907 +08:00

ceil函数 使用时间单位对时间戳进行四舍五入，单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。 语法：ceil(expr, unit) 表26 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS timestamp 是 unit 时间单位 String 是 返回值类型：String类型 示例：SELECT CEIL('2023-04-20 11:28:31.770', 'DAY') 表27 查询分析结果 类型 场景 查询语句 CEIL ('2023-04-20 11:28:31.770', 'DAY') 返回结果 2023-04-21 00:00:00.000

timestamp_to_mills函数 将timestamp类型的日期和时间表达式转换为毫秒级的时间戳。 语法：timestamp_to_mills(expr) 表18 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式 timestamp类型 是 返回值类型：Long类型 示例：select timestamp_to_mills(from_unixtime(1626774758000)) 表19 查询分析结果 类型 场景 查询语句 timestamp_to_mills(from_unixtime(1626774758000)) 返回结果 1626774758000

time_ceil函数 将timestamp类型的时间戳按固定周期以四舍五入的方式取整，将其作为新的时间戳返回。Period可以是任何ISO8601的周期，如P3M（季度）或PT12H（半天）。 time_ceil(expr, period) 表22 参数说明 参数名称 描述 类型 是否必选 expr 日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 period ISO8601的周期 String 是 返回值类型：timestamp类型 示例1：SELECT time_ceil(from_unixtime(__time),'PT1M') 表23 查询分析结果 类型 场景 查询语句 SELECT time_ceil(from_unixtime(__time),'PT1M') 返回结果 2025-05-30 14:58:00.000 Asia/Shanghai Period描述：period的格式应为P[n]Y[n]M[n]DT[n]H[n]M[n]S或P[n]W。在这些表示中，【n】是日期和时间元素的数量。不需要前导零，但每个元素的最大位数应由通信各方商定。大写字母P、Y、M、W、D、T、H、M和S是每个日期和时间元素的指示符，不被替换。 P是放置在持续时间表示的开始处的持续时间指示符（对于期间）。 Y是日历年数值之后的年指示符。 M是日历月数值之后的月份指示符。 W是周数值之后的周指示符。 D是日历天数值之后的日期指示符。 T是表示的时间分量之前的时间指示符。 H是小时数值之后的小时指示符。 M是分钟指示符，紧随分钟数的值。 S是秒数值之后的第二个指示符。 例如，“P3Y6M4DT12H30M5S”表示“三年六个月四天十二小时三十分五秒”的持续时间。 更多信息，请访问https://en.wikipedia.org/wiki/ISO_8601

to_unixtime函数 将timestamp类型的日期和时间表达式转换毫秒级的时间戳。 语法：to_unixtime(expr) 表20 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式 timestamp 是 返回值类型：Long类型 示例：SELECT to_unixtime(from_unixtime(1626774758000)) 表21 查询分析结果 类型 场景 查询语句 to_unixtime(from_unixtime(1626774758000)) 返回结果 1626774758

time_floor函数 将timestamp类型的时间戳按时间戳返回。Period可以是任何ISO8601的周期，如P3M（季度）或PT12H（半天）。 语法：time_floor(expr, period) 表24 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS TimeZone timestamp 是 period ISO8601的周期 String 是 返回值类型：timestamp类型 示例1：SELECT TIME_FLOOR(from_unixtime(1626774758000), 'PT2H') 表25 查询分析结果 类型 场景 查询语句 TIME_FLOOR(from_unixtime(1626774758000), 'PT2H') 返回结果 2021-07-20 16:00:00.000 Asia/Shanghai

to_iso8601函数 将日期类型或时间戳类型的日期时间表达式转换为ISO8601格式的日期时间表达式。 语法：to_iso8601(expr) 表16 参数说明 参数名称 描述 类型 是否必选 expr timestamp类型的日期和时间表达式 timestamp类型 是 返回值类型：String类型 示例：SELECT TO_ISO8601(from_unixtime(1626774758000)) 表17 查询分析结果 类型 场景 查询语句 TO_ISO8601(FROM_UNIXTIME(1626774758000)) 返回结果 2021-07-20T17:52:38.000+08:00

from_unixtime函数 将秒级或毫秒级时间戳转换为日期和时间表达式。当expr取值小于315360000000（10年）毫秒值时为秒。 将秒级或毫秒级时间戳转化为时间戳类型的日期和时间表达式。 语法：from_unixtime(expr) 表9 参数说明 参数名称 描述 类型 是否必选 expr 秒级或毫秒级时间戳 Long 是 返回值类型：timestamp 示例：SELECT FROM_UNIXTIME(1626774758000) 表10 查询分析结果 类型 场景 查询语句 FROM_UNIXTIME(1626774758000) 返回结果 2021-07-20 17:52:38.000 Asia/shanghai 示例：SELECT FROM_UNIXTIME(1731916857) 表11 查询分析结果 类型 场景 查询语句 FROM_UNIXTIME(1731916857) 返回结果 2024-11-18 16:00:57.000 Asia/shanghai 将秒级或毫秒级时间戳转化为带特定时区的timestamp类型的日期和时间表达式。 语法：from_unixtime(expr, timezone) 表12 参数说明 参数名称 描述 类型 是否必选 expr UNIX时间戳 Long 是 timezone 时区 String 是 返回值类型：String类型 示例：SELECT FROM_UNIXTIME(1626774758000, 'Asia/Shanghai') 表13 查询分析结果 类型 场景 查询语句 FROM_UNIXTIME(1626774758000, 'Asia/Shanghai') 返回结果 2021-07-20 17:52:38.000 Asia/Shanghai 将秒级或毫秒级时间戳转换为具有特定时区的日期和时间表达式。表达式中，hour和minute表示时区偏移量。 语法：from_unixtime(expr, hour, minutes) 表14 参数说明 参数名称 描述 类型 是否必选 expr UNIX时间戳 Long 是 hour 小时 Integer 是 minute 分钟 Integer 是 返回值类型：String 示例：SELECT FROM_UNIXTIME(1626774758000, -2, 0) 表15 查询分析结果 类型 场景 查询语句 FROM_UNIXTIME(1626774758000, -2, 0) 返回结果 2021-07-20 07:52:38.000 -02:00

from_iso8601_date函数 将ISO8601格式的日期表达式转化为date类型的日期表达式，格式为YYYY-MM-DD。 语法：from_iso8601_date(expr) 表3 参数说明 参数名称 描述 类型 是否必选 expr ISO8601格式的日期表达式 String 是 返回值类型：String类型 示例：SELECT FROM_ISO8601_DATE('2018-05-14') 表4 查询分析结果 类型 场景 查询语句 FROM_ISO8601_DATE('2018-05-14') 返回结果 2018-05-14

current_timestamp函数 返回当前日期和时间，格式为yyyy-MM-dd HH:mm:ss.SSS。 语法：current_timestamp() 返回值类型：timestamp类型 示例：SELECT CURRENT_TIMESTAMP() 表2 查询分析结果 类型 场景 查询语句 CURRENT_TIMESTAMP() 返回结果 2025-05-29 20:09:17.656 Asia/Shanghai

mills_to_timestamp函数 将毫秒级的时间戳转换为timestamp类型的时间和日期表达式。 将毫秒级的时间戳转化为timestamp类型的日期和时间表达式，格式为yyyy-MM-dd HH:mm:ss.SSS。 语法：mills_to_timestamp(expr) 表7 参数说明 参数名称 描述 类型 是否必选 expr UNIX时间戳 Long 是 返回值类型：timestamp类型 示例：SELECT MILLS_TO_TIMESTAMP(1626774758000) 表8 查询分析结果 类型 场景 查询语句 MILLS_TO_TIMESTAMP(1626774758000) 返回结果 2021-07-20 17:52:38.000 Asia/Shanghai

from_iso8601_timestamp函数 将ISO8601格式的日期和时间表达式转化为timestamp类型的日期和时间表达式，格式为YYYY-MM-DD HH:MM:SS.Ms Time_zone。 语法：from_iso8601_timestamp(expr) 表5 参数说明 参数名称 描述 类型 是否必选 expr ISO8601格式的日期和时间表达式 String 是 返回值类型：timestamp类型。 示例：SELECT FROM_ISO8601_TIMESTAMP('2018-05-14T11:51:50.153+08:00') 表6 查询分析结果 类型 场景 查询语句 FROM_ISO8601_TIMESTAMP('2018-05-14T11:51:50.153+08:00') 返回结果 2018-05-14 11:51:50.153 +08:00

函数列表 表1 日期和时间函数 函数 描述 current_timestamp函数 返回当前日期和时间，格式为yyyy-MM-dd HH:mm:ss.SSS from_iso8601_date函数 将ISO8601格式的日期表达式expr转换为date类型的日期表达式，格式为yyyy-MM-dd from_iso8601_timestamp函数 将ISO8601格式的日期表达式expr转换为timestamp类型的日期表达式，格式为yyyy-MM-dd HH:mm:ss.SSS mills_to_timestamp函数 将UNIX时间戳转换为日期和时间表达式。 from_unixtime函数 将UNIX时间戳转换为日期和时间表达式。与mills_to_timestamp函数用法一致。 to_iso8601函数 将日期类型或时间戳类型的日期时间表达式转换为ISO8601格式的日期时间表达式。 timestamp_to_mills函数 将时间戳类型的日期和时间表达式转换为UNIX时间戳。 to_unixtime函数 将时间戳类型的日期和时间表达式转换为UNIX时间戳。与timestamp_to_mills函数用法一致。 time_ceil函数 将时间戳舍入，将其作为新的时间戳返回。Period可以是任何ISO8601的周期，如P3M（季度）或PT12H（半天）。指定Origin作为时间戳，以设置舍入的参考时间。例如，TIME_CEIL(time, 'PT1H', '2016-06-27 00:30:00')测量的小时周期从00:30-01:30而不是00:00-01:00。时区（如果提供）应该是时区名称，如“America/Los_Angeles”或偏移量，如“-08:00”。 time_floor函数 向下舍入时间戳，将其作为新的时间戳返回。Period可以是任何ISO8601的周期，如P3M（季度）或PT12H（半天）。指定Origin作为时间戳，以设置舍入的参考时间。例如，TIME_FLOOR(time, 'PT1H', '2016-06-27 00:30:00')测量的小时周期从00:30-01:30而不是00:00-01:00。时区（如果提供）应该是时区名称，如“America/Los_Angeles”或偏移量，如“-08:00”。 ceil函数 使用时间单位对时间戳进行四舍五入，单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。 floor函数 使用时间单位对时间戳进行向下舍入，单位可以是SECOND、MINUTE、 HOUR、 DAY、 WEEK、 MONTH、 QUARTER或 YEAR。 time_shift函数 将时间戳expr移动一个Period（步长时间）。Period可以是任何ISO8601的Period。 timezone_hour函数 计算系统时区和utc时区的小时偏移量。如果提供了时区，则计算系统时区与给定时区的偏移量。 timezone_minute函数 计算系统时区和utc时区的分钟偏移量。如果提供了时区，则计算系统时区与给定时区的偏移量。 time_format函数 将时间戳类型的日期和时间表达式转换为指定格式的日期和时间表达式。 date_format函数 将时间戳类型的日期和时间表达式转换为指定格式的日期和时间表达式。 time_parse函数 将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。 date_parse函数 将日期和时间字符串转换为指定格式的时间戳类型的日期和时间表达式。 time_extract函数 通过指定字段提取日期时间表达式的日期或时间部分。EPOCH, SECOND, MINUTE, HOUR, DAY(月的日), DOW（周的日）, DOY（年的日）, WEEK（年周）, MONTH（1到12）, QUARTER（1到4）,或YEAR,时区（如果提供）应为时区名称，如"America/Los_Angeles"或偏移量，如"-08:00" date_trunc函数 根据您指定的时间单位截断日期和时间表达式，并以毫秒、秒、分钟、小时、天、月或年为单位对齐。 date_diff函数 返回时间戳expr1和时间戳expr2之间的单位数（有符号）。 current_date函数 返回当前日期，格式是“yyyy-MM-dd”。 now函数 返回当前日期和时间，格式是“yyyy-MM-dd HH:mm:ss.SSS”。功能与current_timestamp一致 date_add函数 给时间加上给定的时间间隔 current_time函数 返回当前时间，格式为HH:mm:ss.SSSSSS。 current_timezone函数 返回当前时区。 localtime函数 返回本地时间。 localtimestamp函数 返回本地的日期和时间。 year_of_week函数 返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。 yow函数 返回目标日期在ISO周日历中的年份。year_of_week函数等同于yow函数。 time_series函数 用于补全您查询时间窗口内缺失的数据。

创建消息模板 登录 云日志 服务控制台。 左侧导航选择“日志告警”，进入告警页面，选择“告警通知规则”。 消息模板默认有以下内置模板，当您所选择的消息模板中未配置消息内容时，云日志服务默认使用内置模板。 关键词模板：关键词告警模板 keywords_template：关键词告警英文模板 sql模板：sql告警模板 sql_template：sql告警英文模板 在消息模板页签，单击“创建”，在界面右侧弹出的“创建消息模板”页面中，配置消息模板的相关参数。 邮件内容支持html标签和消息预览。 企业微信、钉钉、飞书支持markdown语法和消息预览。 针对 AOM 和LTS，最多可以创建100（包含）条消息模板，如果消息模板数量已达上限100个时，请删除不需要的消息模板后重新创建。 表1 配置消息模板参数 参数名称 说明 校验规则 样例 模板名称 消息模板的名称 输入内容只能是数字、字母、下划线、汉字、中划线，且不能以下划线、中划线等特殊符号开头和结尾。长度不能超过100个字符。 LTS-test 模板描述 对消息模板的描述 输入内容只能是数字、字母、下划线、汉字，且不能以下划线等特殊符号开头和结尾。长度不能超过1024个字符。 - 消息头语言 系统在发送消息时会默认添加消息头 中文（简体） 英文 中文：“尊敬的用户...” 英文：“Dear User...” 通知方式 消息的通知方式类型 邮件 短信 HTTP/HTTPS 钉钉 飞书 企业微信 语音，此功能仅针对白名单用户提交工单申请使用。详细操作请参考提交工单。 welink，此功能仅针对白名单用户提交工单申请使用。详细操作请参考提交工单。 - 主题 消息的主题 支持自定义主题名称和使用变量命名主题两种方式。主题名称长度不能超过512个字符。 仅邮件类型支持配置消息主题。 test 正文 消息的内容 添加变量： 规则原始名称：${event_name} 告警级别：${event_severity} 发生时间：${starts_at} 发生区域：${region_name} 华为云账号：${domain_name} 告警源：$event.metadata.resource_provider 资源类型：$event.metadata.resource_type 资源标识：${resources} 告警状态：$event.annotations.alarm_status 表达式：$event.annotations.condition_expression 当前值：$event.annotations.current_value 表达式带值：$event.annotations.condition_expression_with_value 统计周期：$event.annotations.frequency 规则名称：$event.annotations.alarm_rule_alias 通知频率：$event.annotations.notification_frequency 日志组原始名称：$event.annotations.results[0].log_group_name 日志流原始名称：$event.annotations.results[0].log_stream_name 日志组名称：$event.annotations.results[0].log_group_name_alias 日志流名称：$event.annotations.results[0].log_stream_name_alias 关键词告警支持的变量 查询时间：$event.annotations.results[0].time 查询日志：（日志长度最多2KB，超过2KB被截断丢弃） $event.annotations.results[0].raw_results 查询URL： $event.annotations.results[0].url 日志组/日志流名称：$event.annotations.results[0].resource_id 只支持添加首次创建的日志组/日志流原始名称，不支持添加修改后的日志组/日志流名称。 日志流的企业项目ID：$event.annotations.results[0].eps_id 查询自定义字段$event.annotations.results[0].fields.xxx xxx表示原始日志的结构化字段和内置字段（hostIP、hostName等），日志字段长度最多1KB，超过1KB被截断丢弃。 SQL告警支持的变量 图表0的日志组/流名称：$event.annotations.results[0].resource_id 只支持添加首次创建的日志组/日志流原始名称，不支持添加修改后的日志组/日志流名称。 0代表第一个图表，1代表第二个图表，以此类推。 图表0的查询语句：$event.annotations.results[0].sql 图表0的查询时间：$event.annotations.results[0].time 图表0的查询URL：$event.annotations.results[0].url 图表0的查询日志：$event.annotations.results[0].raw_results 图表0的日志流的企业项目ID：$event.annotations.results[0].eps_id 复制模板： keywords_template sql_template sql模板 关键词模板 自定义模板（用户通过添加变量创建的消息模板） ${event_name} ${event_severity} ${starts_at} ${region_name} 配置完成后，单击“确定”。 在LTS页面创建消息模板时提示“创建消息模板失败，名称不能重复”，可以参考如下步骤进行排查处理。 请检查消息模板名称是否有重复。 若有重复，请重新修改消息模板名称。因为，LTS的消息模板数据源与AOM消息模板数据源为同一个，消息模板名称不能重复，如果在AOM中创建了名称为test的消息模板，在LTS页面不能创建同名的消息模板。 请检查消息模板数量是否超过100个。 针对AOM和LTS，最多可以创建100（包含）条消息模板，当消息模板数量已达上限100个时，请删除不需要的消息模板后重新创建。

约束与限制 LTS会自动检测主机安装的ICAgent插件版本。 如果检测到您的主机中后期不维护的ICAgent插件版本时，当您进入LTS控制台后，界面会弹出“ICAgent版本太低”的提示框，您可以根据实际需求单击“授权自动升级”授权LTS为您在业务低峰期自动升级ICAgent插件，或单击“前往手动升级”前往主机管理页面升级ICAgent，详细操作请参考管理ICAgent。如果您暂不需要升级ICAgent插件，可勾选“不再提示”前的复选框，取消提示信息。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从 IAM 获取的用户Token，获取方式请参见：获取用户Token。 最小长度：1000 最大长度：2000 Content-Type 是 String 该字段填为：application/json;charset=UTF-8。 最小长度：30 最大长度：30 Content-Encoding 否 String 日志压缩格式。 枚举值： GZIP SNAPPY gzip snappy 表3 请求Body参数 参数 是否必选 参数类型 描述 contents 是 Array of LogContents 包含上报时间戳的日志内容列表。 labels 是 Object 用户自定义label。 请不要将字段名称设置为内置保留字段，否则可能会造成字段名称重复、查询不精确等问题。 tenant_project_id 否 String 租户项目ID，获取方式请参见：获取账号ID、项目ID、日志组ID、日志流ID。 表4 LogContents 参数 是否必选 参数类型 描述 log_time_ns 是 Long 日志数据上报时间，UTC时间（纳秒）。 通过接口上报日志到LTS的时间相距当前时间不超过2天，否则上报日志会被LTS删除。 log 是 String 日志内容。

请求示例 POST https://{接入点IP:8102}/v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents/high-accuracy { "contents": [ { "log_time_ns": 1586850540000000000, "log": "Fri Feb 15 15:48:04 UTC 2019" }, { "log_time_ns": 1586850540000000001, "log": "Sat April 18 16:04:04 UTC 2019" } ], "labels": { "user_tag": "string" } }