日期和時間函式

日期和時間函式用於對(PQL)中的值執行日期和時間 Profile Query Language 操作。 有關其他PQL函式的詳細資訊，請參閱 Profile Query Language 概述。

當月

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

Format

currentMonth()

範例

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

person.birthMonth = currentMonth()

取得月份

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

Format

{TIMESTAMP}.getMonth()

範例

以下PQL查詢檢查人員的出生月份是否在6月。

person.birthdate.getMonth() = 6

本年度

此函 currentYear 數會以整數傳回目前的年份。

Format

currentYear()

範例

以下PQL查詢會檢查產品是否在當年售出。

product.saleYear = currentYear()

取得年份

函式 getYear 會根據指定的時間戳記，以整數形式傳回年份。

Format

{TIMESTAMP}.getYear()

範例

以下PQL查詢檢查人員的出生年數是否在1991、1992、1993、1994或1995年。

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

當月當天

此函 currentDayOfMonth 數會以整數傳回當月的當天。

Format

currentDayOfMonth()

範例

以下PQL查詢檢查人員的出生日是否與當月的當天匹配。

person.birthDay = currentDayOfMonth()

取得每月的某天

函式 getDayOfMonth 會根據指定的時間戳記，以整數形式傳回該日。

Format

{TIMESTAMP}.getDayOfMonth()

範例

以下PQL查詢會檢查該項目是否在當月的前15天內售出。

product.sale.getDayOfMonth() <= 15

發生

該 occurs 函式將給定時間戳函式與固定時段進行比較。

Format

函 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 後跟時間單位)或時間戳記屬性。

範例

以下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函式的詳細資訊，請閱讀配置式查 詢語言概述。