Le funzioni di data e ora sono utilizzate per eseguire operazioni di data e ora sui valori all'interno di Profile Query Language (PQL). Ulteriori informazioni sulle altre funzioni PQL sono disponibili nella Profile Query Language panoramica.
La funzione currentMonth
restituisce il mese corrente come numero intero.
Formato
currentMonth()
Esempio
La seguente query PQL verifica se il mese di nascita della persona è il mese corrente.
person.birthMonth = currentMonth()
La funzione getMonth
restituisce il mese, sotto forma di numero intero, in base a una data marca temporale.
Formato
{TIMESTAMP}.getMonth()
Esempio
La seguente query PQL verifica se il mese di nascita della persona è in giugno.
person.birthdate.getMonth() = 6
La funzione currentYear
restituisce l'anno corrente come numero intero.
Formato
currentYear()
Esempio
La seguente query PQL verifica se il prodotto è stato venduto nell’anno corrente.
product.saleYear = currentYear()
La funzione getYear
restituisce l'anno, sotto forma di numero intero, in base a una data marca temporale.
Formato
{TIMESTAMP}.getYear()
Esempio
La seguente interrogazione PQL verifica se l'anno di nascita della persona cade nel 1991, 1992, 1993, 1994 o 1995.
person.birthday.getYear() in [1991, 1992, 1993, 1994, 1995]
La funzione currentDayOfMonth
restituisce il giorno corrente del mese come numero intero.
Formato
currentDayOfMonth()
Esempio
La seguente query PQL verifica se il giorno di nascita della persona corrisponde al giorno corrente del mese.
person.birthDay = currentDayOfMonth()
La funzione getDayOfMonth
restituisce il giorno, sotto forma di numero intero, in base a una data marca temporale.
Formato
{TIMESTAMP}.getDayOfMonth()
Esempio
La seguente query PQL verifica se l'articolo è stato venduto entro i primi 15 giorni del mese.
product.sale.getDayOfMonth() <= 15
La funzione occurs
confronta la funzione timestamp specificata con un periodo di tempo fisso.
Formato
La funzione occurs
può essere scritta utilizzando uno dei seguenti formati:
{TIMESTAMP} occurs {COMPARISON} {INTEGER} {TIME_UNIT} {DIRECTION} {TIME}
{TIMESTAMP} occurs {DIRECTION} {TIME}
{TIMESTAMP} occurs (on) {TIME}
{TIMESTAMP} occurs between {TIME} and {TIME}
Argomento | Descrizione |
---|---|
{COMPARISON} |
Un operatore di confronto. Può essere uno dei seguenti operatori: > , >= , < , <= , = , != . Ulteriori informazioni sulle funzioni di confronto si trovano nel documento funzioni di confronto. |
{INTEGER} |
Un numero intero non negativo. |
{TIME_UNIT} |
Unità di tempo. Può essere una delle seguenti parole: millisecond(s) , second(s) , minute(s) , hour(s) , day(s) , week(s) , month(s) , year(s) , decade(s) , century , centuries , millennium , millennia . |
{DIRECTION} |
Una preposizione che descrive quando confrontare la data con. Può essere una delle seguenti parole: before , after , from . |
{TIME} |
Può essere un letterale di marca temporale (today , now , yesterday , tomorrow ), un'unità di tempo relativa (una di this , last o next seguita da un'unità di tempo) o un attributo di marca temporale. |
L'utilizzo della parola on
è facoltativo. È lì per migliorare la leggibilità di alcune combinazioni, come timestamp occurs on date(2019,12,31)
.
Esempio
La seguente query PQL verifica se l'articolo è stato venduto la settimana scorsa.
product.saleDate occurs last week
La seguente query PQL verifica se un articolo è stato venduto tra l’8 gennaio 2015 e il 1 luglio 2017.
product.saleDate occurs between date(2015, 1, 8) and date(2017, 7, 1)
now
è una parola riservata che rappresenta la marca temporale dell'esecuzione PQL.
Esempio
La seguente query PQL verifica se un articolo è stato venduto esattamente tre ore prima.
product.saleDate occurs = 3 hours before now
today
è una parola riservata che rappresenta la marca temporale dell'inizio del giorno dell'esecuzione PQL.
Esempio
La seguente query PQL verifica se il compleanno di una persona è stato tre giorni fa.
person.birthday occurs = 3 days before today
Ora che hai imparato le funzioni di data e ora, puoi utilizzarle nelle query PQL. Per ulteriori informazioni sulle altre funzioni PQL, leggere la Panoramica del linguaggio di query profilo.