日期和时间函数

日期和时间函数用于对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)、相对时间单位(thislastnext之一,后跟时间单位)或时间戳属性。
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