timestamp.get_day_of_week
timestamp.get_day_of_week(unix_seconds [, time_zone])
說明
這個函式會傳回 [1, 7]
範圍內的整數,代表星期幾 (以週日做為每週起始日)。例如 1 代表星期日,2 代表星期一。
unix_seconds
是代表 Unix 紀元後經過秒數的整數,例如$e.metadata.event_timestamp.seconds
,或是包含該值的預留位置。time_zone
為選用項目,代表 time_zone 的字串。如果省略,預設值為「GMT」。您可以使用字串常值指定時區。選項包括:- 時區資料庫名稱,例如「America/Los_Angeles」。詳情請參閱這個頁面的「時區資料庫名稱」欄。
- 與世界標準時間的時區偏移量,格式為
(+|-)H[H][:M[M]]
,例如「-08:00」。
以下是有效的時區指定符範例,您可以將這些指定符做為第二個引數傳遞至時間擷取函式:
"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
傳回類型
INT
程式碼範例
範例 1
在本範例中,我們省略了 time_zone
引數,因此預設為「GMT」。
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_day_of_week($ts) = 6
範例 2
這個範例使用字串常值定義 time_zone
。
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_day_of_week($ts, "America/Los_Angeles") = 6