文件 Journey Optimizer Journey Optimizer 指南

日期函式 date-functions

Last update: Wed Nov 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

適用對象：
Journey Orchestration

主題：

建立對象：

經驗豐富
開發人員

日期函式可讓您在歷程運算式中控制和使用日期和時間值。這些功能對於客戶歷程中以時間為基礎的條件、排程和時間計算至關重要。

有以下需求時，請使用日期函式：

取得目前時間或具有特定時區處理的日期(now，nowWithDelta，currentTimeInMillis)
檢查日期是否落在特定時間範圍內(inLastDays，inLastHours，inLastMonths，inLastYears，inNextDays，inNextHours，inNextMonths，inNextYears)
修改日期和時間元件(setHours， setDays， updateTimeZone)
執行以時間為基礎的計算和比較
在不同時間格式和表示之間轉換

日期函式可精確控制暫時邏輯，讓您建立對時間敏感的歷程路徑和條件，以回應特定時間範圍和排程。

currentTimeInMillis currentTimeInMillis

傳回目前時間（以Epoch毫秒為單位）。

語法

currentTimeInMillis()

參數

此函式不使用引數。

簽章與傳回型別

currentTimeInMillis()

傳回整數。

範例

currentTimeInMillis()

傳回「1544712617131」。

inLastDays inLastDays

如果指定的dateTime介於現在與現在 — 差異天數之間，則傳回true。

語法

inLastDays(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inLastDays(<dateTime>,<integer>)

傳回布林值。

範例

inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)

傳回true。

inLastHours inLastHours

如果指定的日期時間介於現在和現在之間 — 差異小時，則傳回true。

語法

inLastHours(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inLastHours(<dateTime>,<integer>)

傳回布林值。

範例

inLastHours(toDateTime('2023-12-12T01:11:00Z'), 4)

傳回true。

inLastHours(@event{MyEvent.timestamp}, 4)

傳回true。

inLastMonths inLastMonths

如果指定的日期或dateTime介於現在和現在 — 差異月份之間，則傳回true。

語法

inLastMonths(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inLastMonths(<dateTime>,<integer>)

傳回布林值。

範例

inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)

傳回true。

inLastYears inLastYears

如果指定的日期或dateTime介於現在和現在之間 — 差異年份，則傳回true。

語法

inLastYears(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inLastYears(<dateTime>,<integer>)

傳回布林值。

範例

inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)

傳回true。

inNextDays inNextDays

如果指定的日期或日期時間介於現在和現在+差異天數之間，則傳回true。

語法

inNextDays(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inNextDays(<dateTime>,<integer>)

傳回布林值。

範例

inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)

傳回true。

inNextHours inNextHours

如果指定的日期或日期時間介於現在和現在+差異小時之間，則傳回true。

語法

inNextHours(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inNextHours(<dateTime>,<integer>)

傳回布林值。

範例

inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)

傳回true。

inNextMonths inNextMonths

如果指定的日期或dateTime介於現在和現在+差異月份之間，則傳回true。

語法

inNextMonths(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inNextMonths(<dateTime>,<integer>)

傳回布林值。

範例

inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)

傳回true。

inNextYears inNextYears

如果指定的日期或dateTime介於現在和現在+差異年度之間，則傳回true。

語法

inNextYears(<dateTime>,<delta>)

參數

table 0-row-2 1-row-2 2-row-2
參數	類型
日期時間	dateTime
delta	整數

簽章與傳回型別

inNextYears(<dateTime>,<integer>)

傳回布林值。

範例

inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)

傳回true。

now now

以日期時間格式傳回目前日期。如需資料型別的詳細資訊，請參閱此頁面。

語法

now(<parameter>)

參數

table 0-row-2 1-row-2
參數	說明
字串	時區識別碼（選擇性）

簽章與傳回型別

now()

now("<timeZone id>")

傳回日期時間。

範例

now()

傳回2023-06-03T06:30Z。

toString(now())

傳回「2023-06-03T06:30Z」

now("Europe/Paris")

傳回2023-06-03T08:30+02:00。

nowWithDelta nowWithDelta

傳回包含位移的目前日期時間。如果指定了時區識別碼，則會套用時區位移。如需資料型別的詳細資訊，請參閱此頁面。

語法

nowWithDelta(<parameters>)

參數

table 0-row-2 1-row-2 2-row-2 3-row-2
參數	說明
delta	正或負整數值
日期部分	年、月、日、小時、分鐘或秒做為字串
時區id	時區值的字串表示法。如需詳細資訊，請參閱資料型別。時區ID必須是字串常數。它不能是欄位參考或運算式。

簽章與傳回型別

nowWithDelta(<delta>,<date part>

nowWithDelta(<delta>,<date part>,"<timeZone id>")

傳回日期時間。

範例

nowWithDelta(-2, "hours")

nowWithDelta(-2, "hours", "Europe/Paris")

傳回2小時前的dateTime。

setHours setHours

僅設定日期時間或日期時間的小時。例如，如果您要等到明天的特定小時，則可以強制該小時。

語法

setHours(<parameter>)

參數

table 0-row-2 1-row-2 2-row-2 3-row-2
參數	類型
日期時間	dateTime
不考慮時區的日期時間	dateTimeOnly
小時	整數

簽章與傳回型別

setHours(<dateTime>,<hours>)

傳回日期時間。

setHours(<dateTimeOnly>,<hours>)

傳回日期時間，不考慮時區。

範例

setHours(toDateTime('2023-12-12T01:11:00Z'), 4)

傳回2023-12-12T04:11:00Z。

setHours(nowWithDelta(1, "days"), 20)

傳回明天晚上8:XY，XY是目前時間評估的分鐘數。如果評估發生在上午2:45，則傳回的時間將會是晚上8:45。

setDays setDays

僅設定日期時間或日期時間的日期。例如，如果您要等到月份的某一天，則可以強制該天。

語法

setDays(<parameter>)

參數

table 0-row-2 1-row-2 2-row-2 3-row-2
參數	類型
日期時間	dateTime
不考慮時區的日期時間	dateTimeOnly
天	整數

簽章與傳回型別

setDays(<dateTime>,<days>)

傳回日期時間。

setDays(<dateTimeOnly>,<days>)

傳回日期時間，不考慮時區。

範例

setDays(toDateTime('2023-12-12T01:11:00Z'), 25)

傳回2023-12-25T01:11:00Z。

setDays(toDateTimeOnly(@event{MyEvent.registrationDate}), 1)

updateTimeZone updateTimeZone

傳回新的日期時間，而在同一時間傳回新的時區。

語法

updateTimeZone(<parameters>)

參數

時區id：字串
dateTime

簽章與傳回的型別

updateTimeZone(<dateTime>,<timeZone id>)

傳回日期時間。

範例

updateTimeZone( toDateTime("2023-08-28T08:15:30.123-07:00"), "Europe/Paris"))

傳回2023-08-28T17:15:30.123+02:00。

updateTimeZone(@event{MyExpEvent.timestamp}, "Australia/Sydney")

如果時間戳記欄位的值為2021-11-16T16:55:12.939318+01:00，則函式會傳回2021-11-17T02:55:12.942115+11:00。

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76