日期和時間函式

日期和時間函式用於對以下範圍內的值執行日期和時間作業: 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),相對時間單位(以下之一 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功能的詳細資訊,請參閱 設定檔查詢語言概觀.

本頁內容