日期時間函式
- 主題：
- 個人化
建立對象：
- 經驗豐富
- 開發人員
日期和時間函式可用來對Journey Optimizer中的值執行日期和時間作業。
增加天數
addDays函式會依指定的天數調整指定日期，使用正值增加值，使用負值減少值。
語法
{%= addDays(date, number) %}
- 輸入：
{%= addDays(stringToDate("2024-11-01T17:19:51Z"),10) %} - 輸出：
2024-11-11T17:19:51Z
增加小時數
addHours函式會依指定的小時數調整指定日期，使用正值增加值，使用負值減少值。
語法
{%= addHours(date, number) %}
- 輸入：
{%= addHours(stringToDate("2024-11-01T17:19:51Z"),1) %} - 輸出：
2024-11-01T18:19:51Z
增加分鐘數
addMinutes函式會以指定的分鐘數調整指定日期，使用正值增加值，使用負值減少值
語法
{%= addMinutes(date, number) %}
- 輸入：
{%= addMinutes(stringToDate("2024-11-01T17:59:51Z"),10) %} - 輸出：
2024-11-01T18:09:51Z
增加月數
addMonths函式會依指定的月數調整指定日期，使用正值增加值，使用負值減少值。
語法
{%= addMonths(date, number) %}
- 輸入：
{%= addMonths(stringToDate("2024-11-01T17:19:51Z"),2) %} - 輸出：
2025-01-01T17:19:51Z
增加秒數
addSeconds會以指定的秒數來調整指定日期，使用正值來遞增，使用負值來遞減。
語法
{%= addSeconds(date, number) %}
- 輸入：
{%= addSeconds(stringToDate("2024-11-01T17:19:51Z"),10) %} - 輸出：
2024-11-01T17:20:01Z
增加年數
addYears會依指定的年數來調整指定日期，使用正值來遞增，使用負值來遞減。
語法
{%= addYears(date, number) %}
- 輸入：
{%= addYears(stringToDate("2024-11-01T17:19:51Z"),2) %} - 輸出：
2026-11-01T17:19:51Z
年齡
age函式用於從給定日期擷取年齡。
語法
{%= age(datetime) %}
年齡 (以天為單位)
ageInDays函式會以天數計算指定日期的存留期，即指定日期與目前日期之間經過的天數，未來日期為負數，過去日期為正數。
語法
{%= ageInDays(date) %}
currentDate = 2025-01-07T12:17:10.720122+05:30 （亞洲/加爾各答）
- 輸入：
{%= ageInDays(stringToDate("2025-01-01T17:19:51Z"))%} - 輸出：
5
年齡 (以月為單位)
ageInMonths函式會以月為單位計算指定日期的年齡，也就是指定日期和目前日期之間經過的月數，未來日期的負數與過去日期的正數。
語法
{%= ageInMonths(date) %}
currentDate = 2025-01-07T12:22:46.993748+05:30（亞洲/加爾各答）
- 輸入：
{%=ageInMonths(stringToDate("2024-01-01T00:00:00Z"))%} - 輸出：
12
比較日期
compareDates函式會比較第一個輸入日期與另一個輸入日期。 如果date1等於date2，則傳回0；如果date1在date2之前，則傳回–1；如果date1在date2之後，則傳回1。
語法
{%= compareDates(date1, date2) %}
- 輸入：
{%=compareDates(stringToDate("2024-12-02T00:00:00Z"), stringToDate("2024-12-03T00:00:00Z"))%} - 輸出：
-1
轉換分區日期時間
convertZonedDateTime函式將日期時間轉換為指定的時區。
語法
{%= convertZonedDateTime(dateTime, timezone) %}
- 輸入：
{%=convertZonedDateTime(stringToDate("2019-02-19T08:09:00Z"), "Asia/Tehran")%} - 輸出：
2019-02-19T11:39+03:30[Asia/Tehran]
目前時間 (以毫秒為單位)
currentTimeInMillis函式用於擷取目前時間（以Epoch毫秒為單位）。
語法
{%= currentTimeInMillis() %}
日期差異
dateDiff函式用於擷取兩個日期之間的天數差異。
語法
{%= dateDiff(datetime,datetime) %}
當月的第幾天
dayOfWeek會傳回代表該月某日的數字。
語法
{%= dayOfMonth(datetime) %}
- 輸入：
{%= dayOfMonth(stringToDate("2024-11-05T17:19:51Z")) %} - 輸出：
5
星期幾
dayOfWeek函式用於擷取星期幾。
語法
{%= dayOfWeek(datetime) %}
年中的日
dayOfYear函式用於擷取一年當中的第幾天。
語法
{%= dayOfYear(datetime) %}
差異 (以秒為單位)
diffInSeconds函式傳回兩個日期之間的秒數差。
語法
{%= diffInSeconds(endDate, startDate) %}
- 輸入：
{%=diffInSeconds(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T17:19:01Z"))%} - 輸出：
50
擷取小時
extractHours函式會從指定的時間戳記中擷取時數元件。
語法
{%= extractHours(date) %}
- 輸入：
{%= extractHours(stringToDate("2024-11-01T17:19:51Z"))%} - 輸出：
17
擷取分鐘
extractMinutes函式會從指定的時間戳記中擷取分鐘元件。
語法
{%= extractMinutes(date) %}
- 輸入：
{%= extractMinute(stringToDate("2024-11-01T17:19:51Z"))%} - 輸出：
19
擷取月份
extractMonth函式會從指定的時間戳記中擷取月份元件。
語法
{%= extractMonths(date) %}
- 輸入：
{%=extractMonth(stringToDate("2024-11-01T17:19:51Z"))%} - 輸出：
11
擷取秒
extractSeconds函式會從指定的時間戳記中擷取第二個元件。
語法
{%= extractSeconds(date) %}
- 輸入：
{%=extractSeconds(stringToDate("2024-11-01T17:19:51Z"))%} - 輸出：
51
格式化日期
formatDate函式用來格式化日期時間值。 格式應為有效的Java DateTimeFormat模式。
語法
{%= formatDate(datetime, format) %}
其中第一個字串是日期屬性，第二個值是您想要轉換和顯示日期的方式。
範例
下列作業將傳回下列格式的日期：MM/DD/YY。
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/dd/YY") %}
支援地區設定的日期格式
formatDate函式可用來將日期時間值格式化成對應的語言敏感表示法，亦即所需的地區設定。 格式應為有效的Java DateTimeFormat模式。
語法
{%= formatDate(datetime, format, locale) %}
其中第一個字串是日期屬性，第二個值是您轉換和顯示日期的方式，第三個值代表字串格式的地區設定。
範例
下列作業將傳回下列格式的日期： MM/DD/YY和locale FRANCE。
{%= formatDate(profile.timeSeriesEvents._mobile.hotelBookingDetails.bookingDate, "MM/DD/YY", "fr_FR") %}
取得目前分區日期時間
getCurrentZonedDateTime函式傳回目前日期和時間，並附上時區資訊。
語法
{%= getCurrentZonedDateTime() %}
- 輸入：
{%= getCurrentZonedDateTime() %} - 輸出：
2024-12-06T17:22:02.281067+05:30[Asia/Kolkata]
小時差
diffInHours函式傳回兩個日期之間的時數差。
語法
{%= diffInHours(endDate, startDate) %}
- 輸入：
{%= diffInHours(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T07:19:51Z"))%} - 輸出：
10
分鐘差
diffInMinutes函式用來傳回兩個日期之間的差異（以分鐘為單位）。
語法
{%= diffInMinutes(endDate, startDate) %}
- 輸入：
{%= diffInMinutes(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-11-01T16:19:51Z"))%} - 輸出：
60
月差
diffInMonths函式傳回兩個日期之間的月差。
語法
{%= diffInMonths(endDate, startDate) %}
- 輸入：
{%=diffInMonths(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2024-08-01T17:19:51Z"))%} - 輸出：
3
設定天數
setDays函式用來設定指定日期時間的月份日期。
語法
{%= setDays(datetime, day) %}
設定時數
setHours函式是用來設定日期時間的小時。
語法
{%= setHours(datetime, hour) %}
至日期時間
ToDateTime函式將字串轉換為日期。 針對無效輸入會傳回epoch日期作為輸出。
語法
{%= toDateTime(string, string) %}
- 輸入：
{%=toDateTime("2024-11-01T17:19:51Z")%} - 輸出：
2024-11-01T17:19:51Z
到 UTC
toUTC函式用於將日期時間轉換為UTC。
語法
{%= toUTC(datetime) %}
截斷至當天的開始
truncateToStartOfDay函式是用來修改指定的日期時間，方法是將其設定為當天的開始，而時間設定為00:00。
語法
{%= truncateToStartOfDay(date) %}
- 輸入：
{%= truncateToStartOfDay(stringToDate("2024-11-01T17:19:51Z")) %} - 輸出：
2024-11-01T00:00Z
截斷至季的開始
truncateToStartOfQuarter函式用於將日期時間截斷為其季度的第一天（例如，1月1日、4月1日、7月1日、10月1日）的00:00。
語法
{%= truncateToStartOfQuarter(dateTime) %}
- 輸入：
{%=truncateToStartOfQuarter(stringToDate("2024-11-01T17:19:51Z"))%} - 輸出：
2024-10-01T00:00Z
截斷至週的開始
truncateToStartOfWeek函式將指定日期時間設定為一週的開始（星期一的00:00），以修改指定的日期時間。
語法
{%= truncateToStartOfWeek(dateTime) %}
- 輸入：
truncateToStartOfWeek(stringToDate("2024-11-19T17:19:51Z"))%} // tuesday - 輸出：
2024-11-18T00:00Z // monday
截斷至年的開始
truncateToStartOfYear函式是用來修改指定的日期時間，方法是在00:00將日期時間截斷為一年的第一天（1月1日）。
語法
{%= truncateToStartOfYear(dateTime) %}
- 輸入：
{%=truncateToStartOfYear(stringToDate("2024-11-01T17:19:51Z"))%} - 輸出：
2024-01-01T00:00Z
年中的週
weekOfYear函式用於擷取該年的周數。
語法
{%= weekOfYear(datetime) %}
年差
diffInYears函式是用來傳回兩個日期之間的年差。
語法
{%= diffInYears(endDate, startDate) %}: int
- 輸入：
{%=diffInYears(stringToDate("2024-11-01T17:19:51Z"), stringToDate("2019-10-01T17:19:51Z"))%} - 輸出：
5