日期和时间函数

日期和时间函数用于对 Profile Query Language (PQL)。 有关其他PQL函数的更多信息,请参见 Profile Query Language 概述.

当前月份

currentMonth 函数以整数形式返回当前月份。

格式

currentMonth()

示例

以下PQL查询检查个人的出生月是否为当月。

person.birthMonth = currentMonth()

获取月份

getMonth 函数以整数的形式返回月份,具体情况基于给定的时间戳。

格式

{TIMESTAMP}.getMonth()

示例

以下PQL查询检查个人的出生月份是否为6月。

person.birthdate.getMonth() = 6

当前年份

currentYear 函数以整数形式返回当前年份。

格式

currentYear()

示例

以下PQL查询检查产品是否在本年度销售。

product.saleYear = currentYear()

获取年份

getYear 函数根据给定的时间戳以整数的形式返回年份。

格式

{TIMESTAMP}.getYear()

示例

以下PQL查询检查个人的出生年份是1991、1992、1993、1994还是1995。

person.birthday.getYear() in [1991, 1992, 1993, 1994, 1995]

当月

currentDayOfMonth 函数以整数形式返回月份的当前日期。

格式

currentDayOfMonth()

示例

以下PQL查询检查人员的出生日期是否与当月的当天匹配。

person.birthDay = currentDayOfMonth()

获取每月的日期

getDayOfMonth 函数以整数的形式返回基于给定时间戳的日。

格式

{TIMESTAMP}.getDayOfMonth()

示例

以下PQL查询检查该项是否在该月的前15天内销售。

product.sale.getDayOfMonth() <= 15

发生

occurs 函数将给定时间戳函数与固定时间段进行比较。

格式

occurs 函数可使用以下任意格式进行编写:

{TIMESTAMP} occurs {COMPARISON} {INTEGER} {TIME_UNIT} {DIRECTION} {TIME}
{TIMESTAMP} occurs {DIRECTION} {TIME}
{TIMESTAMP} occurs (on) {TIME}
{TIMESTAMP} occurs between {TIME} and {TIME}
参数
描述
{COMPARISON}
比较运算符。 可以是以下任一运算符: >>=<<==!=. 有关比较函数的更多信息,请参见 比较函数文档.
{INTEGER}
非负整数。
{TIME_UNIT}
时间单位。 可以是以下任一单词: millisecond(s)second(s)minute(s)hour(s)day(s)week(s)month(s)year(s)decade(s)centurycenturiesmillenniummillennia.
{DIRECTION}
描述何时将日期与进行比较的前置词。 可以是以下任一单词: beforeafterfrom.
{TIME}
可以是时间戳文字(todaynowyesterdaytomorrow),相对时间单位(其中之一) thislast,或 next 后跟时间单位)或时间戳属性。
NOTE
单词的用法 on 是可选的。 这样可以提高某些组合的可读性,例如 timestamp occurs on date(2019,12,31).

示例

以下PQL查询检查该项上周是否售出。

product.saleDate occurs last week

以下PQL查询检查2015年1月8日至2017年7月1日之间是否售出了一件商品。

product.saleDate occurs between date(2015, 1, 8) and date(2017, 7, 1)

现在

now 是一个保留字,表示PQL执行的时间戳。

示例

以下PQL查询检查项目是否在三小时前刚刚售出。

product.saleDate occurs = 3 hours before now

今天

today 是一个保留字,表示PQL执行之日开始的时间戳。

示例

以下PQL查询检查个人的生日是否为三天前。

person.birthday occurs = 3 days before today

后续步骤

现在您已了解日期和时间函数,可以在PQL查询中使用它们。 有关其他PQL功能的详细信息,请参阅 配置文件查询语言概述.

recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871