날짜 함수 date-functions

currentTimeInMillis()

정수 반환.

currentTimeInMillis()

"1544712617131"를 반환합니다.

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

이 단원에는 이 주제와 관련된 해석, 검색 및 질문 답변을 지원하기 위한 구조화된 지식이 포함되어 있습니다.

이해를 돕기 위해 이 정보를 이 페이지의 설명서와 통합해야 합니다. 두 소스 모두 독립적으로 사용하기 위한 것은 아닙니다. 이 페이지에서는 기능에 대해 설명하지만, 용어, 의도, 적용 가능성 및 제약 조건을 명확히 하는 데 도움이 되는 추가 컨텍스트를 제공합니다.

• TL;DR: 이 페이지에서는 AJO 여정 표현식에서 사용할 수 있는 모든 날짜 및 시간 함수를 문서화하고, 현재 시간을 얻는 방법을 다루고, 날짜가 상대 시간 기간에 속하는지 여부를 확인하고, 날짜/시간 구성 요소를 수정하는 방법을 설명합니다.

의도:

• now 또는 nowWithDelta을(를) 사용하여 현재 날짜/시간(선택적 시간대 포함) 가져오기
• currentTimeInMillis을(를) 사용하여 현재 시간을 에포크 정수로 검색
• 날짜/시간이 inLastDays, inLastHours, inLastMonths, inLastYears을(를) 사용하여 최근 N일, 시간, 월 또는 년 이내에 속하는지 확인
• inNextDays, inNextHours, inNextMonths, inNextYears을(를) 사용하여 날짜/시간이 다음 N일, 시간, 월 또는 년 이내에 속하는지 확인
• setHours 또는 setDays을(를) 사용하여 datetime 값에 특정 시간 또는 월 일 강제 적용
• updateTimeZone을(를) 사용하여 동일한 인스턴스를 유지하면서 날짜/시간을 다른 시간대로 변환

용어집:

• dateTime: 시간대 오프셋 정보 (제품별)가 포함된 날짜-시간 값
• dateTimeOnly: 시간대 정보가 없는 날짜-시간 값 (제품별)
• epoch 밀리초: 1970-01-01T00:00:00Z 이후 경과된 시간(밀리초)을 나타내는 정수
• delta: 현재 시간을 년, 월, 일, 시간, 분 또는 초로 보내기 위해 nowWithDelta과(와) 함께 사용되는 정수 오프셋(양수 또는 음수)입니다.

보호 기능:

• now()은(는) 여정 식에서만 사용할 수 있습니다. 전자 메일 개인화를 위해 getCurrentZonedDateTime()을(를) 대신 사용하십시오.
• nowWithDelta의 시간대 ID는 문자열 상수여야 합니다. 필드 참조 및 동적 식은 지원되지 않습니다.
• updateTimeZone의 시간대 ID는 문자열 상수여야 합니다.

용어:

• 정식 이름: 날짜 함수 — 약어: 없음 — 변형: 날짜-시간 함수, 임시 함수
• 동의어: “now()” = “current datetime”; “currentTimeInMillis()” = “current epoch milliseconds”
• 혼동하지 마십시오. “inLastDays”(시간 후 전환) ≠ “inNextDays”(시간 후 전환)
• 혼동하지 마십시오. “setHours”(시간 구성 요소 대체) ≠ “nowWithDelta”(현재 시간 오프셋)
• 혼동하지 마십시오. “updateTimeZone”(같은 인스턴트, 다른 시간대 표시) ≠ “setHours”(시간 값 자체를 변경)

FAQ:

• Q: 전자 메일 개인화 콘텐츠에서 now()을(를) 사용할 수 있습니까? — 아니요. now()은(는) 여정 식에서만 사용할 수 있습니다. 전자 메일 개인화에 getCurrentZonedDateTime()을(를) 사용합니다.
• Q: 지난 24시간 동안 이벤트가 발생했는지 어떻게 확인할 수 있습니까? — inLastHours(@event{MyEvent.timestamp}, 24) 사용.
• Q: 지난 2시간 동안 현재 시간 오프셋을 가져오려면 어떻게 해야 합니까? — nowWithDelta(-2, "hours") 사용.
• Q: updateTimeZone이(가) setHours과(와) 다르게 수행하는 작업 — updateTimeZone은(는) 같은 시간을 유지하지만 다른 시간대에 표시하는 반면 setHours은(는) 실제로 datetime 값의 hour 구성 요소를 변경합니다.
• Q: nowWithDelta의 시간대 매개 변수가 프로필 필드일 수 있습니까? — 아니요. 시간대 ID는 문자열 상수여야 합니다. 필드 참조는 지원되지 않습니다.
• Q: nowWithDelta()을(를) 월과 함께 사용하고 현재 날짜가 월말 날짜인 경우 어떻게 됩니까? — 이 함수는 달력-월 산술을 사용하고 결과를 대상 월의 마지막 유효 날짜로 표준화합니다. 예를 들어, 1월 31일에 1개월을 추가하면 3월 3일이 아닌 2월 28일이 반환됩니다.