timestamp.get_timestamp
timestamp.get_timestamp(unix_seconds, optional timestamp_format/time_granularity, optional timezone)
說明
這個函式會傳回 YYYY-MM-DD 格式的字串，代表時間戳記所在的日期。
unix_seconds是代表 Unix 紀元後經過秒數的整數，例如$e.metadata.event_timestamp.seconds，或是包含該值的預留位置。timestamp_format為選用項目，是代表時間戳記格式的字串。如未填寫此欄位，則預設值為%F %T。您可以透過日期時間格式字串或下列任一時間精細度指定格式：SECOND、MINUTE、HOUR、DATE、WEEK、MONTH或YEAR。如需更多格式設定選項，請參閱日期和時間部分的格式元素time_zone為選用項目，代表時區的字串。如果省略，預設值為GMT。您可以使用字串常值指定時區。選項如下：- IANA 時區 (TZ) 資料庫名稱，例如
America/Los_Angeles。詳情請參閱 Wikipedia 上的 tz 資料庫時區清單。 - 與世界標準時間的時區偏移量，格式為
(+|-)H[H][:M[M]]，例如「-08:00」。
- IANA 時區 (TZ) 資料庫名稱，例如
以下是有效的 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"
範例 4
這個範例會將 Unix 時間戳記格式化為字串，精確度為秒。
timestamp.get_timestamp(1708598631, "SECOND", "GMT") = "2024-02-22 10:43:51"
範例 5
這個範例會將 UNIX 時間戳記格式化為字串，精確度為分鐘。
timestamp.get_timestamp(1708598631, "MINUTE", "GMT") = "2024-02-22 10:43"
範例 6
這個範例會將 Unix 時間戳記格式化為字串，精確度為小時。
timestamp.get_timestamp(1708598631, "HOUR", "GMT") = "2024-02-22 10"
範例 7
這個範例會將 Unix 時間戳記格式化為字串，精細程度為天。
timestamp.get_timestamp(1708598631, "DATE", "GMT") = "2024-02-22"
範例 8
這個範例會將 Unix 時間戳記格式化為字串，並以週為單位。
timestamp.get_timestamp(1708598631, "WEEK", "GMT") = "2024-02-18"
範例 9
這個範例會將 UNIX 時間戳記格式化為字串，精確度為月份。
timestamp.get_timestamp(1708598631, "MONTH", "GMT") = "2024-02"
範例 10
這個範例會將 Unix 時間戳記格式化為字串，精確度為年。
timestamp.get_timestamp(1708598631, "YEAR", "GMT") = "2024"