日期和時間函式
日期和時間函式是用來對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)、century、centuries、millennium、millennia。{DIRECTION}說明何時將日期與進行比較的預置詞。 可以是下列任一字詞:
before、after、from。{TIME}可以是時間戳記常值(
today、now、yesterday、tomorrow)、相對時間單位(this、last或next其中之一,後面接著時間單位)或時間戳記屬性。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