timestamp.get_week
timestamp.get_week(unix_seconds [, time_zone])
說明
這個函式會傳回 [0, 53] 範圍內的整數,代表一年中的週數。每週從星期日開始,如果日期在該年度第一個星期日之前,則屬於第 0 週。
unix_seconds是代表 Unix 紀元後秒數的整數,例如$e.metadata.event_timestamp.seconds,或是包含該值的預留位置。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
傳回類型
INT
程式碼範例
範例 1
在本範例中,我們省略了 time_zone 引數,因此系統會預設為「GMT」。
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_week($ts) = 0
範例 2
這個範例使用字串常值定義 time_zone。
$ts = $e.metadata.collected_timestamp.seconds
timestamp.get_week($ts, "America/Los_Angeles") = 0