日期和時間函式

日期和時間函式用於對(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} 可以是時間戳記常值(todaynowyesterdaytomorrow)、相對時間單位(時間單位之一、 thislast 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函式的詳細資訊,請閱讀配置式查 詢語言概述

本頁內容