You need to enable JavaScript to run this app.
导航
日期值处理函数
最近更新时间:2023.11.13 16:31:35首次发布时间:2023.02.16 18:06:17

本文档介绍日期值处理函数的语法与格式、相关的场景示例等。

dt_str 函数

时间处理函数,将时间日期值转为指定时区、指定格式的时间字符串。

函数语法/格式

dt_str(value, fmt="目标格式", tz=None)

参数说明如下:

参数

参数类型

是否必选

默认值

取值范围

说明

value

String

/

/

待转换的时间日期值。

fmt

String

/

/

输出的日期字符串格式。

tz

String

/

时区列表

转换的目标时区,默认为 None 。

函数示例

  • 场景:将日志中 time 字段的值转换为时间后,按照字段 fmt 指定的格式输出到字段 dt_str 中。

  • 加工规则:

    f_set("dt_str", dt_str(v("time"), fmt=v("fmt")))
    
  • 日志样例:

    {
        "time":"2022-12-26 13:03:21",
        "fmt":"%Y/%m/%d %H-%M-%S"
    }
    
  • 加工结果:

    {
        "time":"2022-12-26 13:03:21",
        "fmt":"%Y/%m/%d %H-%M-%S",
        "dt_str":"2022/12/26 13-03-21"
    }
    

dt_to_timestamp 函数

将时间类的字段值按照指定的时区转换后,转换为 UTC 时间戳。

函数语法/格式

dt_to_timestamp(value, tz=None)

参数说明如下:

参数

参数类型

是否必选

默认值

取值范围

说明

value

String

/

/

待转换的值。

tz

String

/

时区列表

转换的目标时区。

函数示例

  • 场景:将日志中的 time 字段的值按照 tz 字段指定的时区转换为时间后,输出 UTC 时间戳。

  • 加工规则:

    f_set("dt_to_timestamp", dt_to_timestamp(v("time"), v("tz")))
    
  • 日志样例:

    {
        "time":"2022-12-26 13:03:21",
        "tz":"Asia/Shanghai"
    }
    
  • 加工结果:

    {
        "time":"2022-12-26 13:03:21",
        "tz":"Asia/Shanghai",
        "dt_to_timestamp":1672031001
    }
    

dt_from_timestamp 函数

将时间类的时间戳字段,按照指定的时区转换为时间后,转换为时间字符串。

函数语法/格式

dt_from_timestamp(value, tz=None)

参数说明如下:

参数

参数类型

是否必选

默认值

取值范围

说明

value

Number

/

/

待转换的值。

tz

String

/

时区列表

转换的目标时区。

函数示例

  • 场景:将日志中的 time 字段的值按照 tz 字段指定的时区转换为时间后,输出时间字符串。

  • 加工规则:

    f_set("dt_from_timestamp", dt_from_timestamp(v("time"), tz=v("tz")))
    
  • 日志样例:

    {
        "time":"1672057815"
    }
    
  • 加工结果:

    {
        "time":"1672057815",
        "dt_from_timestamp":"2022-12-26 20:30:15"
    }
    

dt_now 函数

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

函数语法/格式

dt_now(tz="")

参数说明如下:

参数

参数类型

是否必选

默认值

取值范围

说明

tz

String

/

时区列表

转换的目标时区。

函数示例

  • 场景:根据日志中的 tz 字段指定的时区,获取加工时的本地时间,输出到字段 dt_now 中。

  • 加工规则:

    f_set("dt_now", dt_now(tz=v("tz")))
    
  • 日志样例:

    {
        "tz":"Asia/Shanghai"
    }
    
  • 加工结果:

    {
        "tz":"Asia/Shanghai",
        "dt_now":"2022-12-27 19:56:31.223646+08:00"
    }