日期和时间函数
日期和时间函数用于对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
之一,后跟时间单位)或时间戳属性。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功能的更多信息,请阅读Profile Query Language概述。
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871