华为云用户手册

round函数 用于对x进行四舍五入。如果n存在，则保留n位小数；如果n不存在，则对x进行四舍五入取整数。 对x进行四舍五入取整数。 语法：round(x) 对x进行四舍五入且保留n位小数。 语法：round(x, n) 表2 参数说明 参数名称 描述 类型 是否必选 x 原始字段。 double 是 n n位小数(int)。 int 是 返回值类型：double 示例：select round(num,4) 示例数据num：3.1415926 表3 查询分析结果 类型 场景 查询语句 select round(num,4) 返回结果 3.1416

创建主机组（自定义标识） 选择自定义标识主机组类型时，需要提前规划好需要添加标识的主机，且主机已安装ICAgent。 单击右上角“新建主机组”。 在弹出的新建主机组页面，输入“主机组名称”，主机组类型选择“自定义标识”，主机类型选择“Linux主机”或“Windows主机”。自定义填写备注信息，字符长度0-1024个字符。 单击，输入自定义标识信息。 最多可添加10个自定义标识。 单击“确定”，主机组自定义标识创建完成后，请参考5将主机加入自定义标识主机组。 执行以下操作创建custom_tag文件，用来保存主机标签。 登录主机执行如下命令查看是否有/opt/cloud目录。 cd /opt/cloud 若提示没有/opt/cloud目录，执行如下命令创建/opt/cloud目录。 mkdir /opt/cloud/ 若有/opt/cloud目录，在cloud目录下，执行如下命令创建lts目录。 mkdir lts 继续执行如下命令，修改lts目录权限。 chmod 750 lts 在lts目录下执行如下命令，创建custom_tag文件 。 touch custom_tag 继续执行如下命令，修改custom_tag权限并打开该文件。 chmod 640 custom_tag;vi custom_tag 按i进入insert模式，键入自定义标识后，按ESC键，“:wq!”保存退出即可。 :wq! 支持以下两种方式将主机加入到自定义标识主机组： 表1 添加方式 类型 方式1（推荐使用） 方式2 Linux主机 在主机里/opt/cloud/lts目录下的custom_tag文件中，查看该主机的标识，然后将该主机的标识，添加为主机组自定义标识，就可以将主机加入到该主机组下。例如：在主机里/opt/cloud/lts目录下的custom_tag文件中，查看该主机的标识为test1，创建主机组的自定义标识为test1，即将该主机加入到主机组下。 在主机里/opt/cloud/lts目录下的custom_tag文件中，添加主机组自定义标识，可以将主机加入到该主机组下。例如：主机组的自定义标识为test，则在custom_tag文件中填写test，就可以将主机加入到该主机组下。 当添加了多个自定义标识时，在主机里/opt/cloud/lts目录下的custom_tag文件中，任意填写一个自定义标识，就可以将主机加入到该主机组下。 Windows主机 在主机里C:\opt\cloud\lts目录下的custom_tag文件中，查看该主机的标识，然后将该主机的标识，添加为主机组自定义标识，就可以将主机加入到该主机组下。例如：在主机里C:\opt\cloud\lts目录下的custom_tag文件中，查看该主机的标识为test1，创建主机组的自定义标识为test1，即将该主机加入到主机组下。 在主机里C:\opt\cloud\lts目录下的custom_tag文件中，添加主机组自定义标识，可以将主机加入到该主机组下。例如：主机组的自定义标识为test，则在custom_tag文件中填写test，就可以将主机加入到该主机组下。 当添加了多个自定义标识时，在主机里C:\opt\cloud\lts目录下的custom_tag文件中，任意填写一个自定义标识，就可以将主机加入到该主机组下。

批量设置多个接入配置 支持同时批量设置多个接入配置，操作简单，不用重复配置即可快速完成多个场景的接入配置。 在“接入管理”页面，单击“批量创建”，进入配置详情页面。 接入类型：选择ServiceStage-云主机日志。 规则列表： 在输入框填写接入配置数量，单击“添加接入配置”。 在规则列表下方默认已有1个接入配置，最多支持再添加99个数量，因此支持同时添加100个接入配置。 在右侧配置项下方自定义填写“规则名称”，配置项设置完成后，也可以双击左侧接入配置的名称自定义命名。规则名称只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。长度为1-64个字符。 鼠标放在接入配置上面，单击即可直接复制接入配置。 鼠标放在接入配置上面，单击，在弹出的提示框单击“确定”删除接入配置。 配置项： 左侧显示接入配置的信息，最多支持添加99个配置。 右侧显示配置接入的内容，详细请参考步骤3：采集配置进行设置。 一个接入配置设置完成后，单击“应用于其他接入配置”即可将该接入配置复制到其他接入配置。 单击“参数检查”，检查成功后，单击“提交”，批量接入设置完成。 例如添加了4个接入配置，批量创建成功后，在“接入管理”下方，就会显示4条接入配置数量。 （可选）支持对接入配置任务进行以下操作： 勾选多个已创建成功的接入配置，单击“批量编辑”进入配置详情页面，通过选择不同接入类型，修改对应的接入配置信息。 勾选多个接入配置开关显示关闭的接入配置，单击“接入配置开启/关闭”，选择“开启”即可批量开启接入配置任务。 勾选多个接入配置开关显示开启的接入配置，单击“接入配置开启/关闭”，选择“关闭”。接入配置状态关闭后不会继续采集日志，请谨慎操作。 勾选多个已创建成功的接入配置，单击删除按钮即可批量删除接入配置。

步骤4：索引配置 索引是一种存储结构，用于对日志数据进行查询。通过配置索引后，可对日志进行查询和分析操作。不同的索引配置，则会产生不同的查询和分析结果，请根据您的需要，合理配置索引。 若您暂时无需通过某字段进行查询或分析，接入时可以直接跳过索引配置，不影响日志采集。待日志接入成功后，再根据业务需求优化索引配置（仅对新写入的日志生效），详细操作请参考创建LTS日志索引。在“索引配置”页面保持默认设置，直接单击“跳过并提交”，界面提示“日志接入成功”。 若您需要通过特定字段进行查询或分析，接入时请在“索引配置”页面参考创建LTS日志索引配置索引。 您可以单击“自动配置”， 云日志服务LTS 会根据近15分钟的第一条日志内容或常见内置保留字段（例如hostIP、hostName、pathFile）自动生成字段索引，您也可以根据自己的需要增加或者删除字段。设置完成后，单击“提交”，界面提示“日志接入成功”。日志接入成功后，您仍可以根据业务需求随时调整索引配置（仅对新写入的日志生效）。

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函数 用于补全您查询时间窗口内缺失的数据。