timestamp.get_timestamp

支持的平台：

规则 搜索

timestamp.get_timestamp(unix_seconds, optional timestamp_format, optional timezone)

说明

此函数会返回一个格式为 YYYY-MM-DD 的字符串，表示时间戳所在的天。

• unix_seconds 是一个表示经过 Unix 计时原点的秒数（例如 $e.metadata.event_timestamp.seconds）的整数，或一个包含该值的占位符。
• timestamp_format 是可选的，是表示时间戳格式的字符串。如果省略，则默认值为 %F %T。您可以使用字符串字面量指定格式。如需了解选项，请参阅设置日期和时间部分的元素格式
• time_zone 是可选的，是表示时区的字符串。如果省略，则默认值为 GMT。您可以使用字符串字面量来指定时区。选项如下：
  • IANA 时区 (TZ) 数据库名称，例如 America/Los_Angeles。如需了解详情，请参阅 Wikipedia 上的 tz 数据库时区列表。
  • 相对于世界协调时间 (UTC) 的时区偏移量，格式为 (+|-)H[H][:M[M]]，例如“-08:00”。

以下是有效 time_zone 说明符的示例，您可以将其作为第二个参数传递给时间提取函数：

"America/Los_Angeles", or "-08:00". ("PST" is not supported)
"America/New_York", or "-05:00". ("EST" is not supported)
"Europe/London"
"UTC"
"GMT"

参数数据类型

INT、STRING、STRING

返回类型

STRING

代码示例

示例 1

在此示例中，省略了 time_zone 参数，因此默认值为 GMT。

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts) = "2024-02-22 10:43:51"

示例 2

以下示例使用字符串字面量来定义 time_zone。

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts, "%F %T", "America/Los_Angeles") = "2024-02-22 10:43:51"

示例 3

以下示例使用字符串字面量来定义 timestamp_format。

$ts = $e.metadata.collected_timestamp.seconds

timestamp.get_timestamp($ts, "%Y-%m", "GMT") = "2024-02"