日期和時間函式

日期和時間函式是用來對Profile Query Language (PQL)中的值執行日期和時間作業。 如需其他PQL函式的詳細資訊,請參閱Profile Query Language 總覽

當月

currentMonth函式以整數傳回目前月份。

格式

currentMonth()

範例

以下PQL查詢會檢查個人的出生月是否為當月。

person.birthMonth = currentMonth()

取得月份

getMonth函式會根據指定的時間戳記,以整數傳回月份。

格式

{TIMESTAMP}.getMonth()

範例

以下PQL查詢會檢查個人的出生月份是否為六月。

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