日期和時間函式
日期和時間函式用於對Profile Query Language (PQL)內的值執行日期和時間操作。 有關其他PQL函式的詳細資訊，請參閱Profile Query Language overview。
當月
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)、week(s)、month(s)、year(s)、decade(s)、century、centuries、millennium、millennia。day(s) |
{DIRECTION} |
描述日期比較時機的前置詞。 可以是下列任何字詞：before、after、from。 |
{TIME} |
可以是時間戳記常值(today、now、yesterday、tomorrow)、相對時間單位（this、last或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函式的詳細資訊，請閱讀配置檔案查詢語言概述。
