Funzioni data date-functions
Le funzioni di data consentono di manipolare e utilizzare i valori di data e ora all'interno delle espressioni di percorso. Queste funzioni sono essenziali per le condizioni basate sul tempo, la pianificazione e i calcoli temporali nei percorsi dei clienti.
Utilizza le funzioni data quando devi:
- Ottieni l'ora o la data corrente con gestione del fuso orario specifica (now, nowWithDelta, currentTimeInMillis)
- Controlla se una data rientra in un intervallo di tempo specifico (inLastDays, inLastHours, inLastMonths, inLastYears, inNextDays, inNextHours, inNextMonths, inNextYears)
- Modifica componenti data e ora (setHours, setDays, updateTimeZone)
- Eseguire calcoli e confronti basati sul tempo
- Conversione tra diversi formati e rappresentazioni temporali
Le funzioni di data forniscono un controllo preciso sulla logica temporale, consentendo di creare percorsi e condizioni di percorso sensibili al tempo che rispondono a specifici intervalli di tempo e pianificazioni.
currentTimeInMillis currentTimeInMillis
Restituisce il tempo corrente in millisecondi epoca.
currentTimeInMillis()currentTimeInMillis()
Restituisce un numero intero.
currentTimeInMillis()
Restituisce "1544712617131"
inLastDays inLastDays
Restituisce true se un dato dateTime è compreso tra now e now - delta days.
inLastDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inLastDays(<dateTime>,<integer>)
Restituisce un valore booleano.
inLastDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Restituisce true.
inLastHours inLastHours
Restituisce true se la data e l’ora specificate sono comprese tra now e now - delta hours.
inLastHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inLastHours(<dateTime>,<integer>)
Restituisce un valore booleano.
inLastHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Restituisce true.
inLastHours(@event{MyEvent.timestamp}, 4)
Restituisce true.
inLastMonths inLastMonths
Restituisce true se una data o un'ora specificata è compresa tra now e now - delta mesi.
inLastMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inLastMonths(<dateTime>,<integer>)
Restituisce un valore booleano.
inLastMonths(toDateTime('2023-12-12T01:11:00Z'), 4)
Restituisce true.
inLastYears inLastYears
Restituisce true se una data o un valore dateTime specificato è compreso tra now e now - delta years.
inLastYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inLastYears(<dateTime>,<integer>)
Restituisce un valore booleano.
inLastYears(toDateTime('2023-12-12T01:11:00Z'), 4)
Restituisce true.
inNextDays inNextDays
Restituisce true se una data o un'ora specificata è compresa tra now e now + delta giorni.
inNextDays(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inNextDays(<dateTime>,<integer>)
Restituisce un valore booleano.
inNextDays(toDateTime('2023-12-12T01:11:00Z'), 4)
Restituisce true.
inNextHours inNextHours
Restituisce true se una data o un'ora specificata è compresa tra now e now + delta ore.
inNextHours(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inNextHours(<dateTime>,<integer>)
Restituisce un valore booleano.
inNextHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Restituisce true.
inNextMonths inNextMonths
Restituisce true se una data o un'ora specificata è compresa tra now e now + delta mesi.
inNextMonths(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inNextMonths(<dateTime>,<integer>)
Restituisce un valore booleano.
inNextMonths(toDateTime('2023-01-12T01:11:00Z'), 4)
Restituisce true.
inNextYears inNextYears
Restituisce true se una data o un'ora specificata è compresa tra now e now + delta anni.
inNextYears(<dateTime>,<delta>)| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| delta | intero |
inNextYears(<dateTime>,<integer>)
Restituisce un valore booleano.
inNextYears(toDateTime('2021-12-12T01:11:00Z'), 4)
Restituisce true.
now now
Restituisce la data corrente in formato data e ora. Per ulteriori informazioni sui tipi di dati, consultare questa pagina.
now(<parameter>)| table 0-row-2 1-row-2 | |
|---|---|
| Parametro | Descrizione |
| stringa | Identificatore del fuso orario (facoltativo) |
now()
now("<timeZone id>")
Restituisce un valore dateTime.
now()
Restituisce 2023-06-03T06:30Z.
toString(now())
Restituisce "2023-06-03T06:30Z"
now("Europe/Paris")
Restituisce 2023-06-03T08:30+02:00.
nowWithDelta nowWithDelta
Restituisce il valore datetime corrente comprensivo di un offset. Se viene specificato un ID di fuso orario, verrà applicato lo scostamento del fuso orario. Per ulteriori informazioni sui tipi di dati, consultare questa pagina.
nowWithDelta(<parameters>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parametro | Descrizione |
| delta | valore intero positivo o negativo |
| parte data | anni, mesi, giorni, ore, minuti o secondi come stringa |
| id fuso orario | rappresentazione stringa del valore del fuso orario. Per ulteriori informazioni, vedere Tipi di dati. L’ID del fuso orario deve essere una costante stringa. Non può essere un riferimento di campo né un'espressione. |
nowWithDelta(<delta>,<date part>
nowWithDelta(<delta>,<date part>,"<timeZone id>")
Restituisce un valore dateTime.
nowWithDelta(-2, "hours")
nowWithDelta(-2, "hours", "Europe/Paris")
Restituisce un valore dateTime esattamente 2 ore fa.
setHours setHours
Imposta solo le ore di una data/ora o data/ora. Ad esempio, se desideri aspettare fino a un’ora specifica domani, puoi forzare l’ora.
setHours(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| data e ora senza considerare il fuso orario | dateTimeOnly |
| ore | intero |
setHours(<dateTime>,<hours>)
Restituisce un valore datetime.
setHours(<dateTimeOnly>,<hours>)
Restituisce un valore datetime senza considerare il fuso orario.
setHours(toDateTime('2023-12-12T01:11:00Z'), 4)
Restituisce 2023-12-12T04:11:00Z.
setHours(nowWithDelta(1, "days"), 20)
Restituisce domani alle 20.00, dove XY corrisponde ai minuti al momento della valutazione dell'ora corrente. :XY Se la valutazione viene eseguita alle 02:00, l'ora restituita sarà le 20:00.:45:45
setDays setDays
Imposta solo il giorno di un'ora o di una data. Ad esempio, se desideri attendere fino a un determinato giorno del mese, puoi forzare il giorno.
setDays(<parameter>)| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Parametro | Tipo |
| data e ora | dateTime |
| data e ora senza considerare il fuso orario | dateTimeOnly |
| giorni | intero |
setDays(<dateTime>,<days>)
Restituisce un valore datetime.
setDays(<dateTimeOnly>,<days>)
Restituisce un valore datetime senza considerare il fuso orario.
setDays(toDateTime('2023-12-12T01:11:00Z'), 25)
Restituisce 2023-12-25T01:11:00Z.
setDays(toDateTimeOnly(@event{MyEvent.registrationDate}), 1)
updateTimeZone updateTimeZone
Restituisce una nuova data e ora, con un nuovo fuso orario nello stesso istante.
updateTimeZone(<parameters>)- id fuso orario: stringa
- dateTime
updateTimeZone(<dateTime>,<timeZone id>)
Restituisce un valore datetime.
updateTimeZone( toDateTime("2023-08-28T08:15:30.123-07:00"), "Europe/Paris"))
Restituisce 2023-08-28T17:15:30.123+02:00.
updateTimeZone(@event{MyExpEvent.timestamp}, "Australia/Sydney")
Se il valore del campo timestamp è 2021-11-16T16:55:12.939318+01:00, la funzione restituisce 2021-11-17T02:55:12.942115+11:00.