日期和时间函数用于对 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) , century , centuries , millennium , millennia . |
{DIRECTION} |
描述何时将日期与进行比较的前置词。 可以是以下任一单词: before , after , from . |
{TIME} |
可以是时间戳文字(today , now , yesterday , tomorrow ),相对时间单位(其中之一) this , last ,或 next 后跟时间单位)或时间戳属性。 |
单词的用法 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功能的详细信息,请参阅 配置文件查询语言概述.