timestamp.get_date
timestamp.get_date(unix_seconds [, time_zone])
說明
這個函式會傳回 YYYY-MM-DD 格式的字串,代表時間戳記所在日期。
unix_seconds是代表 Unix 紀元後秒數的整數,例如$e.metadata.event_timestamp.seconds,或是包含該值的預留位置。time_zone為選用項目,代表 time_zone 的字串。如果省略,預設值為「GMT」。您可以使用字串常值指定時區。選項包括:- 時區資料庫名稱,例如「America/Los_Angeles」。詳情請參閱這個頁面的「時區資料庫名稱」欄
- 與世界標準時間的時區時差,格式為
(+|-)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
程式碼範例
範例 1
在本範例中,我們省略了 time_zone 引數,因此系統會預設為「GMT」。
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_date($ts) = "2024-02-19"
範例 2
這個範例使用字串常值定義 time_zone。
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_date($ts, "America/Los_Angeles") = "2024-02-20"