日期时间函数

dt_str函数

函数介绍

将值或时间表达式的值转换为字符串。

语法描述

dt_str(value, fmt="format_string", tz=None)

参数说明

参数名称	参数类型	是否必填	参数描述
value	字符串、Unix时间戳、日期时间对象	是	值或时间表达式。
fmt	String	否	格式化字符串。更多信息，请参见日期时间格式化指令。默认为空，则格式保持不变。
tz	String	否	表示时区，默认为None。更多信息，请参见时区列表。

示例1

把time字段的值转换成fmt形式，时区东京。

原始日志

{
"time":"2019-06-03 02:41:26",
"fmt":"%Y/%m/%d %H-%M-%S",
"tz":"Asia/Tokyo"
}

加工规则

set("dt_str", dt_str(v("time"),fmt=v("fmt"),tz=v("tz")))

加工结果

{
dt_str:"2019/06/03 02-41-26"
fmt:"%Y/%m/%d %H-%M-%S"
time:"2019-06-03 02:41:26"
tz:"Asia/Tokyo"
}

示例2

把time字段的值（Unix时间戳）转换成fmt形式。

原始日志

{
"time":"1559500886",
"fmt":"%Y/%m/%d %H-%M-%S"
}

加工规则

set("dt_str", dt_str(v("time"),fmt=v("fmt")))

加工结果

{
dt_str:"2019/06/02 18-41-26"
fmt:"%Y/%m/%d %H-%M-%S"
time:"1559500886"
}

示例3

把time字段的值转换成默认形式

原始日志

{
"time":"2019-06-03 02:41:26"
}

加工规则

set("dt_str", dt_str(v("time")))

加工结果

{
dt_str:"2019-06-03 02:41:26"
time:"2019-06-03 02:41:26"
}

dt_to_timestamp函数

函数介绍

将日期时间对象转换为Unix时间戳。

语法描述

dt_to_timestamp (timeString)

参数说明

参数名称	参数类型	是否必填	参数描述
timeString	日期时间字符串	是	需要被转换的日期时间对象。

示例

原始日志

{
"time":"2019-06-03 02:41:26"
}

加工规则

set("dt_to_timestamp",dt_to_timestamp(v("time")))

加工结果

{
dt_to_timestamp:1559529686
time:"2019-06-03 02:41:26"
}

dt_from_timestamp函数

函数介绍

将Unix时间戳转换为日期时间对象。

语法描述

dt_from_timestamp(value, tz=None)

参数说明

参数名称	参数类型	是否必填	参数描述
value	String	是	值或时间表达式。
tz	String	否	表示时区，默认为None。更多信息，请参见时区列表。

示例1

原始日志

{
"time":"1559500886"
}

加工规则

set("dt_from_timestamp",dt_from_timestamp(v("time")))

加工结果

{
dt_from_timestamp:"2019-06-02 18:41:26"
time:"1559500886"
}

示例2

原始日志

{
"time":"1559500886",
"tz":"Asia/Shanghai"
}

加工规则

set("dt_from_timestamp",dt_from_timestamp(v("time"),tz=v("tz")))

加工结果

{
  "dt_from_timestamp": "2019-06-03 02:41:26+08:00",
  "time": "1559500886",
  "tz": "Asia/Shanghai"
}

dt_now函数

函数介绍

获取当前日期时间对象。

语法描述

dt_now(tz=None)

参数说明

参数名称	参数类型	是否必填	参数描述
tz	String	否	表示时区，默认为None。更多信息，请参见时区列表。

示例1

获取当前时间，时区是上海。

原始日志

{
"tz":"Asia/Shanghai"
}

加工规则

set("dt_now",dt_now(tz=v("tz")))

加工结果

{
  "dt_now": "2023-04-23 10:46:15.78605745+08:00",
  "tz": "Asia/Shanghai"
}