Ti trovi qui:
Funzioni data per le formule
In CRM Analytics, utilizzare le funzioni data per modificare o calcolare i valori delle date nel procedimento. È possibile, ad esempio, aggiungere e calcolare il tempo ed estrarre un giorno della settimana dai campi data. Gli argomenti delle funzioni data sono le colonne data.
Funzioni data per le formule
Quando si immette una formula utilizzare il nome dell'API della colonna nell'espressione, non l'etichetta. La sezione dei parametri è racchiusa tra parentesi. Ad esempio, si può immettere l'espressione seguente.
datediff(ClosedDate, CreatedDate)| Funzione data | Descrizione | Sintassi |
|---|---|---|
add_months
|
Restituisce la data con il numero di mesi specificato dopo la data iniziale. |
startDate è il campo data su cui viene effettuato il calcolo. num_months è il numero di mesi aggiunti a startDate. Questa funzione non modifica la data risultante in un ultimo giorno del mese se startDate è un ultimo giorno dei mesi. Il giorno del mese risultante è il minimo del giorno della data originale o l'ultimo giorno del mese della data risultante. Ad esempio:
|
current_date
|
Restituisce la data corrente. |
current_date()
|
current_timestamp
|
Restituisce la data e l'ora correnti. |
current_timestamp()
|
datediff
|
Restituisce il numero di giorni tra la data iniziale e la data finale. |
endDate è la più recente delle due date tra cui viene trovata la differenza. startDate è la meno recente delle due date tra cui viene trovata la differenza. |
date_add
|
Restituisce la data con il numero di giorni specificato dopo la data iniziale. |
startDate è il campo data su cui viene effettuato il calcolo. num_days è il numero di giorni aggiunti a startDate. |
date_format
|
Converte l'indicazione oraria in un formato di data specificato. |
field è un campo data/indicazione oraria o stringa da convertire nel formato specificato. 'format' è lo schema del formato di data e ora da seguire. Esempio: restituisce 2024 |
date_sub
|
Rimuove il numero di giorni specificato dalla data iniziale. |
startDate è il campo data su cui viene effettuato il calcolo. num_days è il numero di giorni sottratti da startDate. |
date_trunc
|
Reimposta la parte specificata dell'indicazione oraria e tutte le parti successive su zero (o 01 per la data e l'anno). Specificare la parte dell'indicazione oraria, fmt, con "anno", "trimestre", "mese", "settimana", "giorno", "ora", "minuto" o "secondo". Ad esempio, dateTrunc per "anno" 2019-05-01 12:31:32 restituisce 2019-01-01 00:00:00. Se i dati sono una data e non una data/ora, utilizzare invece la funzione trunc. |
'format' è lo schema del formato di data e ora da seguire. timestamp è una data/indicazione oraria o stringa restituita come indicazione oraria UNIX. Esempio: restituisce il lunedì della settimana della Data chiusura. |
day
|
Restituisce il componente giorno del mese della data/indicazione oraria. |
date è il campo data da cui estrarre il giorno del mese. |
dayofmonth
|
Restituisce il componente giorno del mese della data/indicazione oraria. |
date è il campo data da cui estrarre il giorno del mese. |
dayofweek
|
Restituisce il componente giorno della settimana della data/indicazione oraria. 1 = domenica, 2 = lunedì, ..., 7 = sabato. |
date è il campo data da cui estrarre il giorno della settimana. |
dayofyear
|
Restituisce il componente giorno dell'anno della data/indicazione oraria. |
date è il campo data da cui estrarre il giorno dell'anno. |
months_between
|
Restituisce il numero di mesi tra due indicazioni orarie. Calcola la differenza in base a un mese di 31 giorni arrotondata a 8 cifre, a meno che roundOff=false. Se timestamp1 è successivo a timestamp2, il risultato è positivo. Se timestamp1 e timestamp2 sono nello stesso giorno del mese o entrambi sono l'ultimo giorno del mese, il risultato è un intero e l'ora del giorno viene ignorata. |
timestamp2 è una delle indicazioni orarie da confrontare. timestamp1 è l'altra indicazione oraria da confrontare. roundOff(optional) è un valore booleano che determina se arrotondare il risultato. Questo parametro è facoltativo. |
now
|
Restituisce la data e l'ora correnti nel formato specificato. |
now()
|
to_date
|
Converte la stringa data nel formato di data specificato. Restituisce un valore nullo con un input non valido. |
field è il campo di una stringa di data che si desidera convertire. 'format(optional)' è lo schema del formato di data e ora da seguire. Questo parametro è facoltativo. La funzione segue le regole di casting per una data se il formato non è incluso. |
to_timestamp
|
Converte la stringa indicazione oraria nel formato di indicazione oraria specificato. |
field è il campo di una stringa di indicazione oraria che si desidera convertire. 'format(optional)' è lo schema del formato di indicazione oraria da seguire. Questo parametro è facoltativo. La funzione segue le regole di casting per un'indicazione oraria se il formato non è incluso. |
to_unix_timestamp
|
Restituisce l'indicazione oraria UNIX dell'ora specificata. |
timestamp è una data/indicazione oraria o stringa restituita come indicazione oraria UNIX. format(optional) è lo schema del formato data/ora da seguire. format(optional) viene ignorato se timestamp non è una stringa. Il valore predefinito è "aaaa-MM-gg HH:mm:ss". Questo parametro è facoltativo. Esempio: restituisce |
trunc
|
Sostituisce la parte specificata dell'indicazione oraria e tutte le parti successive, con zeri. |
field è un campo indicazione oraria. 'format(optional)' specifica la parte dell'indicazione oraria da troncare. I valori accettati sono "YEAR", "YYYY", "YY", "MON", "MONTH", "MM", "DAY", "DD", "HOUR", "MINUTE", "SECOND", "WEEK" e "QUARTER". Esempio: restituisce |
Quando si utilizzano funzioni di data e ora, tenere presenti le considerazioni che seguono.
- Queste funzioni sono relative al momento in cui viene eseguito il processo.
nowcurrent_datecurrent_timestampto_unix_timestamp
- Tutte le funzioni di data e di data/ora sono basate sul fuso orario UTC.
- Quando è abilitato il supporto per il fuso orario personalizzato, le funzioni di data e le funzioni di data/ora sono separate. Quando è disabilitata, le funzioni vengono raggruppate.
