Funzioni di data e ora

Le funzioni di data e ora vengono 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.

Mese corrente

La funzione currentMonth restituisce il mese corrente sotto forma di numero intero.

Formato

currentMonth()

Esempio

La seguente query PQL controlla se il mese di nascita della persona è il mese corrente.

person.birthMonth = currentMonth()

Ottieni mese

La funzione getMonth restituisce il mese, come numero intero, in base a una data marca temporale.

Formato

{TIMESTAMP}.getMonth()

Esempio

La seguente query PQL controlla se il mese di nascita della persona è in giugno.

person.birthdate.getMonth() = 6

Anno corrente

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()

Ottieni anno

La funzione getYear restituisce l'anno, come numero intero, in base a una data marca temporale.

Formato

{TIMESTAMP}.getYear()

Esempio

La seguente interrogazione PQL controlla se l'anno di nascita della persona cade nel 1991, 1992, 1993, 1994 o 1995.

person.birthday.getYear() in [1991, 1992, 1993, 1994, 1995]

Giorno corrente del mese

La funzione currentDayOfMonth restituisce il giorno corrente del mese come numero intero.

Formato

currentDayOfMonth()

Esempio

La seguente query PQL controlla se il giorno di nascita della persona corrisponde al giorno corrente del mese.

person.birthDay = currentDayOfMonth()

Ottieni giorno del mese

La funzione getDayOfMonth restituisce il giorno, come numero intero, in base a una data marca temporale.

Formato

{TIMESTAMP}.getDayOfMonth()

Esempio

La seguente query PQL controlla se l’articolo è stato venduto entro i primi 15 giorni del mese.

product.sale.getDayOfMonth() <= 15

Si verifica

La funzione occurs confronta la funzione di marca temporale 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} Operatore di confronto. Può essere uno dei seguenti operatori: >, >=, <, <=, =, !=. Ulteriori informazioni sulle funzioni di confronto sono disponibili 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 in. Può essere una delle seguenti parole: before, after, from.
{TIME} Può essere un valore 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.
NOTA

L'utilizzo della parola on è facoltativo. È disponibile per migliorare la leggibilità di alcune combinazioni, ad esempio timestamp occurs on date(2019,12,31).

Esempio

La seguente query PQL controlla 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)

Subito

now è una parola riservata che rappresenta la marca temporale dell’esecuzione PQL.

Esempio

La seguente query PQL controlla se un articolo è stato venduto esattamente tre ore prima.

product.saleDate occurs = 3 hours before now

Oggi

today è una parola riservata che rappresenta la marca temporale dell’inizio del giorno dell’esecuzione PQL.

Esempio

La seguente query PQL controlla se il compleanno di una persona è stato tre giorni fa.

person.birthday occurs = 3 days before today

Passaggi successivi

Dopo aver appreso le funzioni di data e ora, puoi utilizzarle all’interno delle query PQL. Per ulteriori informazioni sulle altre funzioni PQL, consulta la Panoramica di Profile Query Language.

In questa pagina