timestamp.get_week

支援的國家/地區:
timestamp.get_week(unix_seconds [, time_zone])

說明

這個函式會傳回 [0, 53] 範圍內的整數,代表一年中的週數。每週從星期日開始,如果日期在該年度第一個星期日之前,則屬於第 0 週。

  • unix_seconds 是代表 Unix 紀元後秒數的整數,例如 $e.metadata.event_timestamp.seconds,或是包含該值的預留位置。
  • time_zone 為選用項目,是代表時區的字串。如果省略,預設值為「GMT」。您可以使用字串常值指定時區。選項包括:

以下列舉有效的 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