日志服务 时间值处理函数

三、函数定义

将时间类的字段值（特定格式的日期字符串或者时间戳），转换为指定时区、格式的目标日期字符串。

四、语法描述

dt_str(值, format="格式化字符串", zone="")

五、参数说明

六、示例

原始日志：

{"date":"2014-04-26 13:13:44 +09:00"}

加工规则：

fields_set("result", dt_str(v("date"), format="yyyy-MM-dd HH:mm:ss", zone="UTC+8"))

加工结果：

{"date":"2014-04-26 13:13:44 +09:00","result":"2014-04-26 12:13:44"}

八、函数定义

将时间类的字段值（特定格式的日期字符串），同时指定字段对应的时区，转换为 UTC 时间戳。

九、语法描述

dt_to_timestamp(值, zone="")

十、参数说明

十一、示例

原始日志：

{"date":"2021-10-26 15:48:15"}

加工规则：

fields_set("result", dt_to_timestamp(v("date"), zone="UTC+8"))

加工结果：

{"date":"2021-10-26 15:48:15","result":"1635234495000"}

十三、函数定义

将时间类的时间戳字段，指定目标时区后，转换为时间字符串。

十四、语法描述

dt_from_timestamp(值, zone="")

十五、参数说明

十六、示例

原始日志：

{"date":"1635234495000"}

加工规则：

fields_set("result", dt_from_timestamp(v("date"), zone="UTC+8"))

加工结果：

{"date":"1635234495000","result":"2021-10-26 15:48:15"}

十八、函数定义

获取加工计算时的本地时间。

十九、语法描述

dt_now(format="格式化字符串", zone="")

20、参数说明

21、示例

原始日志：

{"date":"1635234495000"}

加工规则：

fields_set("now", dt_now(format="yyyy-MM-dd HH:mm:ss", zone="UTC+8"))

加工结果，仅参考，具体结果和系统时间相关：

{"date":"1635234495000","now":"2021-MM-dd HH:mm:ss"}

23、函数定义

自定义日志时间，会按照你的加工规则生成新的日志时间，支持 秒、毫秒、微秒、纳秒。点击执行预览后，你可在加工结果中，查看__TIMESTAMP__字段的值，是否已改变为你的预期结果。

24、语法描述

custom_cls_log_time(time)

25、参数说明

26、返回值

UTC 时间戳，例如1565064739000。

27、示例

原始日志：

{"field1": "1","time":"06/Aug/2019 12:12:19"}

加工规则：

custom_cls_log_time(dt_to_timestamp(v("time"), zone="UTC+8"))

加工结果，仅参考，具体结果和系统时间相关：

{"__TIMESTAMP__":"1565064739000", "field1":"1", "time":"06/Aug/2019 12:12:19"}