日期和時間函式
日期和時間函式是用來對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