日期函数 date-functions

currentTimeInMillis()

返回整数。

currentTimeInMillis()

返回“1544712617131”。

inLastDays(<dateTime>,<integer>)

返回布尔值。

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

返回真。

inLastHours(<dateTime>,<integer>)

返回布尔值。

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

返回真。

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

返回真。

inLastMonths(<dateTime>,<integer>)

返回布尔值。

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

返回真。

inLastYears(<dateTime>,<integer>)

返回布尔值。

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

返回真。

inNextDays(<dateTime>,<integer>)

返回布尔值。

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

返回真。

inNextHours(<dateTime>,<integer>)

返回布尔值。

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

返回真。

inNextMonths(<dateTime>,<integer>)

返回布尔值。

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

返回真。

inNextYears(<dateTime>,<integer>)

返回布尔值。

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

返回真。

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(<delta>,<date part>

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

返回日期时间。

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将当前时间检索为epoch整数
• 使用inLastDays、inLastHours、inLastMonths、inLastYears检查日期时间在过去N天、小时、月或年之内
• 使用inNextDays、inNextHours、inNextMonths、inNextYears检查日期时间在接下来的N天、小时、月或年之内
• 使用setHours或setDays在日期时间值上强制使用每月的特定小时或日期
• 将日期时间转换为不同的时区，同时使用updateTimeZone保留相同的瞬间

术语表：

• dateTime：包含时区偏移信息​ （产品特定） ​的日期时间值
• dateTimeOnly：没有时区信息的日期时间值​（产品特定）
• 纪元毫秒：表示自1970-01-01T00:00:00Z以来经过的毫秒数的整数
• 增量：与nowWithDelta一起使用的整数偏移（正或负），用于按年数、月数、天数、小时数、分钟数或秒数偏移当前时间

护栏：

• now()仅在历程表达式中可用；对于电子邮件个性化，请使用getCurrentZonedDateTime()
• nowWithDelta中的时区ID必须是字符串常量 — 不支持字段引用和动态表达式
• updateTimeZone中的时区ID必须是字符串常量

术语：

• 规范名称：日期函数 — 首字母缩略词：none — 变体：日期时间函数，临时函数
• 同义词： “now()” = “current datetime”； “currentTimeInMillis()” = “current epoch milliseconds”
• 请勿混淆：“inLastDays”（回顾时间）≠“inNextDays”（回顾时间）
• 请勿混淆：“setHours”（替换hour组件）≠“nowWithDelta”（偏移当前时间）
• 请勿混淆：“updateTimeZone”（相同的即时、不同的时区表示）≠“setHours”（更改时间值本身）

常见问题解答：

• 问：我能否在电子邮件个性化内容中使用now()？ — 否，now()仅在历程表达式中可用。 使用getCurrentZonedDateTime()进行电子邮件个性化。
• 问：如何检查某个事件是否在过去24小时内发生？ — 使用inLastHours(@event{MyEvent.timestamp}, 24)。
• 问：如何获取过去2小时内的当前时间偏移？ — 使用nowWithDelta(-2, "hours")。
• 问：updateTimeZone与setHours有何不同之处？ — updateTimeZone保留同一时刻的时间，但以不同的时区表示该时刻，而setHours实际更改日期时间值的小时组件。
• 问：nowWithDelta中的时区参数能否为配置文件字段？ — 否，时区ID必须是字符串常量；不支持字段引用。
• 问：如果将nowWithDelta()与月份一起使用，并且当前日期是月末日期，会发生什么情况？ — 函数使用日历月算术并将结果标准化为目标月份的最后一个有效日期。 例如，将1个月添加到1月31日会返回2月28日（而不是3月3日）。