날짜 함수 date-functions

currentTimeInMillis()

정수 반환.

currentTimeInMillis()

"1544712617131"를 반환합니다.

두 매개 변수 모두 동일한 데이터 형식을 사용해야 합니다. 혼합 형식(예: dateOnly과(와) dateTime)은 지원되지 않습니다. 매개 변수는 리터럴 날짜 값, now()과(와) 같은 다른 함수 또는 컨텍스트 특성(이벤트 페이로드 필드, 사용자 지정 작업 응답 필드, 프로필 또는 엔터티 필드 및 변수)일 수 있습니다. 단, dateOnly, dateTimeOnly 또는 dateTime(으)로 형식화되어야 합니다.

dateDiff(<dateOnly>,<dateOnly>)

두 날짜 사이의 일 수를 나타내는 정수를 반환합니다.

dateDiff(<dateTimeOnly>,<dateTimeOnly>)

두 날짜-시간 사이의 밀리초 수를 나타내는 정수를 반환합니다.

dateDiff(<dateTime>,<dateTime>)

두 날짜-시간 사이의 밀리초 수를 나타내는 정수를 반환합니다.

dateDiff(toDateOnly('2023-12-15'), toDateOnly('2023-12-12'))

3(일)을 반환합니다.

dateDiff(toDateTimeOnly('2023-12-15T00:00:00'), toDateTimeOnly('2023-12-12T00:00:00'))

259200000(밀리초, 3일에 해당)를 반환합니다.

dateDiff(now(), toDateTime('2024-12-25T00:00:00Z'))

오늘과 2024년 12월 25일 사이의 밀리초 수를 반환합니다.

dateDiff(#{ExperiencePlatform.ProfileFieldGroup.person.birthDate}, toDateOnly('2023-01-01'))

birthDate이(가) dateOnly(으)로 입력되었다고 가정할 때 프로필의 birthDate 필드와 2023년 1월 1일 사이의 일 수를 반환합니다.

inLastDays(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

inLastHours(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

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

true를 반환합니다.

inLastMonths(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

inLastYears(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

inNextDays(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

inNextHours(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

inNextMonths(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

inNextYears(<dateTime>,<integer>)

부울 반환.

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

true를 반환합니다.

now()

now("<timeZone id>")

dateTime을 반환합니다.

now()

2023-06-03T06:30Z를 반환합니다.

toString(now())

“2023-06-03T06:30Z” 반환

now("Europe/Paris")

2023-06-03T08:30+02:00을 반환합니다.

nowWithDelta(<delta>,<date part>

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

dateTime을 반환합니다.

nowWithDelta(-2, "hours")

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

정확히 2시간 전의 dateTime을 반환합니다.

nowWithDelta(1, "months", "Asia/Tokyo")

2026-01-31에 대해 평가하면 2026-02-28T…를 반환합니다.; 2026-05-31에 대해 평가하면 2026-06-30T…를 반환합니다.

nowWithDelta()은(는) 달력-월 산술 연산을 사용합니다. 대상 월의 일 수가 현재 월별 날짜보다 적은 경우 결과는 해당 월의 마지막 유효 날짜로 표준화됩니다. 함수가 다음 달로 롤오버되지 않습니다.

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(<dateTime>,<days>)

날짜/시간을 반환합니다.

setDays(<dateTimeOnly>,<days>)

시간대를 고려하지 않고 날짜/시간을 반환합니다.

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

2023-12-25T01:11:00Z를 반환합니다.

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

• 시간대 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을(를) 반환합니다.

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page documents all date and time functions available in AJO journey expressions, covering how to get the current time, check whether a date falls within a relative time window, and modify date/time components.

Intents:

• Get the current datetime (with optional timezone) using now or nowWithDelta
• Retrieve the current time as an epoch integer using currentTimeInMillis
• Calculate the difference between two dates or date-times using dateDiff
• Check if a datetime falls within the last N days, hours, months, or years using inLastDays, inLastHours, inLastMonths, inLastYears
• Check if a datetime falls within the next N days, hours, months, or years using inNextDays, inNextHours, inNextMonths, inNextYears
• Force a specific hour or day of the month on a datetime value using setHours or setDays
• Convert a datetime to a different timezone while preserving the same instant using updateTimeZone

Glossary:

• dateOnly: A date value with no time or timezone information (product-specific)
• dateTime: A date-time value that includes timezone offset information (product-specific)
• dateTimeOnly: A date-time value with no timezone information (product-specific)
• epoch milliseconds: An integer representing the number of milliseconds elapsed since 1970-01-01T00:00:00Z
• delta: An integer offset (positive or negative) used with nowWithDelta to shift the current time by a number of years, months, days, hours, minutes, or seconds

Guardrails:

• now() is only available in journey expressions; for email personalization use getCurrentZonedDateTime() instead
• The timezone ID in nowWithDelta must be a string constant — field references and dynamic expressions are not supported
• The timezone ID in updateTimeZone must be a string constant
• dateDiff requires both parameters to be the same data type (dateOnly, dateTimeOnly, or dateTime); mixing types is not supported
• dateDiff returns null if either parameter is null
• dateDiff returns days for dateOnly parameters, but milliseconds (not days) for dateTimeOnly and dateTime parameters — convert accordingly when comparing results across types

Terminology:

• Canonical name: Date functions — Acronym: none — variants: date-time functions, temporal functions
• Synonyms: “now()” = “current datetime”; “currentTimeInMillis()” = “current epoch milliseconds”
• Do not confuse: “inLastDays” (looks back in time) ≠ “inNextDays” (looks forward in time)
• Do not confuse: “setHours” (replaces the hour component) ≠ “nowWithDelta” (offsets the current time)
• Do not confuse: “updateTimeZone” (same instant, different timezone representation) ≠ “setHours” (changes the time value itself)
• Do not confuse: the journey expression editor’s dateDiff (accepts dateOnly, dateTimeOnly, or dateTime; returns days or milliseconds depending on type) ≠ the personalization editor’s dateDiff (accepts only dateTime; always returns days)

FAQ:

• Q: Can I use now() in email personalization content? — No, now() is only available in journey expressions. Use getCurrentZonedDateTime() for email personalization.
• Q: How do I check if an event happened in the last 24 hours? — Use inLastHours(@event{MyEvent.timestamp}, 24).
• Q: How do I get the current time offset by 2 hours in the past? — Use nowWithDelta(-2, "hours").
• Q: What does updateTimeZone do differently from setHours? — updateTimeZone keeps the same instant in time but expresses it in a different timezone, while setHours actually changes the hour component of the datetime value.
• Q: Can the timezone parameter in nowWithDelta be a profile field? — No, the timezone ID must be a string constant; field references are not supported.
• Q: What happens when nowWithDelta() is used with months and the current date is a month-end date? — The function uses calendar-month arithmetic and normalizes the result to the last valid day of the target month. For example, adding 1 month to January 31 returns February 28 (not March 3).