Utilizzo dei valori Data, Data/ora e Ora nelle formule
Le formule Data sono utili per gestire le scadenze dei pagamenti, le età dei contratti e qualsiasi altra funzione dell'organizzazione dipendente dal tempo o dalla data.
Versioni (Edition) richieste
| Disponibile in: Salesforce Classic e Lightning Experience |
| Disponibile in: tutte le versioni |
Per l'utilizzo delle date, sono disponibili due tipi di dati: Data e Data/ora. Un tipo di dati, Ora, è indipendente dalla data per il tracciamento dell'ora, ad esempio l'orario di ufficio. La maggior parte dei valori che vengono utilizzati quando si lavora con le date sono del tipo Data, che memorizzano l'anno, il mese e il giorno. Alcuni campi, ad esempio CreatedDate, sono campi di tipo Data/ora, che memorizzano non soltanto un valore di data, ma anche un valore di ora (memorizzato in GMT ma visualizzato nel fuso orario dell'utente). I campi Data, Data/ora e Ora sono formattati nelle impostazioni internazionali dell'utente quando vengono visualizzati sui rapporti e nelle pagine dei dettagli dei record. La precisione di un valore Ora è espressa in millisecondi. La precisione di un valore Data/ora è espressa in secondi.
È possibile utilizzare operazioni come l'addizione e la sottrazione sui valori Data, Data/ora e Ora per calcolare una data futura o il tempo trascorso tra due date o orari. Se si sottrae una data da un'altra, ad esempio, il valore risultante sarà la differenza tra i due valori iniziali in giorni (tipo di dati numerico). La stessa operazione tra due valori Data/ora restituisce un valore decimale che indica la differenza in numero di giorni, ore e minuti. La stessa operazione tra due valori Ora restituisce millisecondo
Ad esempio, se la differenza tra due valori Data/ora è 5,52, ciò significa che i due valori sono separati da cinque giorni, 12 ore (0,5 di un giorno) e 28 minuti (0,02 di un giorno). È anche possibile aggiungere valori numerici a campi di tipo Data e Data/ora. Ad esempio, l'operazione TODAY() + 3 restituisce tre giorni dopo la data odierna. Per ulteriori informazioni ed esempi sull’utilizzo delle date, vedere Esempi di formule di data.
In tutti gli esempi, le variabili date e date/time vengono utilizzate al posto dei campi o valori effettivi Data e Data/ora.
Tenere presente che le funzioni di data complesse tendono a essere compilate in dimensioni maggiori rispetto alle funzioni formula numeriche o testuali, pertanto potrebbero verificarsi dei problemi relativi alle dimensioni di compilazione delle formule.
TODAY(), NOW() e TIMENOW()
La funzione TODAY() restituisce il giorno, il mese e l'anno correnti come tipo di dati Data. Questa funzione è utile per le formule nelle quali interessa conoscere il numero di giorni trascorsi da una data precedente, la data di un certo numero di giorni nel futuro oppure se si desidera semplicemente visualizzare la data corrente.
La funzione NOW() restituisce il valore Data/ora del momento corrente. È utile quando interessa conoscere specifici orari del giorno oltre alla data.
La funzione TIMENOW() restituisce un valore in GMT che rappresenta l'ora corrente senza la data. Utilizzare questa funzione al posto della funzione NOW() se si desidera l'ora, il minuto, i secondi o i millisecondi correnti. Questo valore è utile per tenere traccia del tempo in caso di turni di lavoro o tempo trascorso.
Per ulteriori informazioni sulla conversione tra valori di tipo Data e Data/ora, vedere Conversione tra Data/ora e Data.
La funzione DATE()
La funzione DATE() restituisce un valore Data, dato un anno, un mese e un giorno. I valori numerici A/M/G e le funzioni YEAR(), MONTH() e DAY() sono parametri validi per la DATE(). Ad esempio, DATE( 2013, 6, 1 ) restituisce il 1° giugno 2013. Analogamente, DATE( YEAR( TODAY() ), MONTH( TODAY() ) + 3, 1) restituisce il valore Data del primo giorno a tre mesi da oggi nell'anno corrente, a condizione che la data sia valida (ad esempio, il mese cade tra 1 e 12).
Se i valori A/M/G inseriti restituiscono una data non valida, la funzione DATE() restituisce un errore, pertanto il controllo degli errori è una parte importante dell'utilizzo dei valori Data. I metodi per la gestione delle date non valide sono descritti in Esempi di formule di data.
Conversione tra Data/ora e Data
I tipi di dati Data e Data/ora non sono intercambiabili, pertanto se si desidera eseguire operazioni tra valori di tipo Data e valori di tipo Data/ora è necessario convertire i valori in modo che siano entrambi dello stesso tipo. Alcune funzioni (ad esempio YEAR(), MONTH() e DAY()) funzionano anche solo sui valori Data, quindi i valori Data/ora devono essere convertiti per primi.
Utilizzare la funzione DATEVALUE( date/time
) per restituire il valore Data di una Data/ora. Ad esempio, per ottenere l'anno da una Data/ora, utilizzare YEAR( DATEVALUE(
date/time ) ) ).
Se una formula fa riferimento a un campo Data/ora ma restituisce una Data, il componente ora viene ignorato senza essere convertito nel fuso orario dell'utente. Questo comportamento può causare una data non corretta. Per correggere il fuso orario dell'utente, utilizzare la funzione DATEVALUE() per convertire il campo Data/ora.
È possibile convertire un valore Data in Data/ora utilizzando la funzione DATETIMEVALUE( date ). L'ora verrà impostata sulle 00:00 dell'ora media di Greenwich (GMT) e quindi convertita nel fuso orario dell'utente che visualizza il record al momento della visualizzazione. Per un utente con sede a San Francisco, DATETIMEVALUE( TODAY() ) restituisce le 17:00 del giorno precedente (durante l'ora legale) anziché le 12:00 del giorno corrente. Per ulteriori informazioni, vedere Nota su Data/ora e sui fusi orari.
Conversione tra Data/ora e Ora
La funzione TIMEVALUE() restituisce un valore del tipo di dati Ora nel formato "HH:MM:SS.MS" (ore:minuti:secondi.millisecondi) utilizzando un orologio di 24 ore. I valori numerici H/M/S/MS e le funzioni HOUR(), MINUTE(), SECONDS() e MILLISECONDS() sono parametri validi per la TIMEVALUE().
Utilizzare la funzione TIMEVALUE(value) per restituire il valore Ora di un tipo, testo, campo di unione o espressione Data/ora. Ad esempio, estrarre l'ora da un valore Data/ora ClosedDate con TIMEVALUE(ClosedDate).
Conversione tra data e testo
Se si desidera includere una data come parte di una stringa, racchiudere il valore Data nella funzione TEXT() per convertirlo in testo. Ad esempio, se si desidera restituire la data di oggi come testo, utilizzare:
"Today's date is " & TEXT( TODAY() )Restituisce la data nel formato "AAAA-MM-GG" anziché nel formato dipendente dalle impostazioni internazionali. È possibile modificare il formato estraendo prima il giorno, il mese e l'anno dalla data e quindi ricombinandoli nel formato desiderato. Ad esempio:
"Today's date is " & TEXT( MONTH( date ) ) & "/" & TEXT( DAY( date ) ) & "/" & TEXT( YEAR( date ) ) ) È anche possibile convertire del testo in una data in modo che il valore della stringa possa essere utilizzato con gli altri campi e formule Data. Sarà richiesto formattare il testo come "AAAA-MM-GG". Utilizzare questa formula per restituire il valore Data:
DATEVALUE( "YYYY-MM-DD" )Conversione tra Data/ora e Testo
È possibile includere valori Data/ora in una stringa utilizzando la funzione TEXT(), ma è necessario prestare attenzione ai fusi orari. Ad esempio, considerare la seguente formula:
"The current date and time is " & TEXT( NOW() )In questa formula, NOW() viene spostato su GMT. Normalmente, i NOW() vengono convertiti nel fuso orario dell'utente quando vengono visualizzati, ma poiché sono stati convertiti in testo, la conversione non avviene. Pertanto, se si esegue questa formula il 1° agosto alle 17:00 ora di San Francisco (GMT-7), il risultato è "La data e l'ora corrente è 2013–08–02 00:00:00Z".
Quando si converte una Data/ora in testo, viene inclusa una "Z" alla fine per indicare l'ora legale. TEXT( date/time ) restituisce "Z" se il campo è vuoto. Perciò, se il valore Data/ora con il quale si sta lavorando potrebbe essere vuoto, controllare prima di procedere alla conversione in testo:
IF(
ISBLANK( date/time ),
"",
TEXT( date/time )
)Per convertire una stringa in un valore Data/ora, utilizzare il passaggio di DATETIMEVALUE() in una stringa nel formato "AAAA-MM-GG HH:MM:SS". Questo metodo restituisce il valore Data/ora in GMT.
Conversione tra Ora e testo
Se si desidera includere il tempo come parte di una stringa, racchiudere il valore Ora nella funzione TEXT() per convertirlo in testo. Ad esempio, se si desidera restituire l’ora corrente come testo, utilizzare:
"The time is " & TEXT( TIMENOW() )Questa funzione restituisce l’ora nel formato "HH:MM:SS.MS".
È anche possibile convertire del testo in un tipo di dati Ora in modo che il valore della stringa possa essere utilizzato con gli altri campi e formule Ora. Formattare il testo utilizzando il formato "HH:MM:SS.MS" con formato 24 ore. Utilizzare la funzione TIMEVALUE():
TIMEVALUE("17:30:45.125")Nota su Data/ora e sui fusi orari
I valori Data e Data/ora sono memorizzati in GMT. Quando un record viene salvato, i valori dei campi vengono modificati dal fuso orario dell'utente a GMT e quindi rettificati nuovamente sul fuso orario dell'utente quando vengono visualizzati nelle pagine dei dettagli dei record e nei rapporti. Con le conversioni di date ciò non costituisce un problema, poiché la conversione di una Data/ora in una Data risulta nello stesso valore Data.
Quando si utilizzano i campi e i valori Data/ora, tuttavia, la conversione viene sempre effettuata in GMT e non nel fuso orario dell'utente. La sottrazione di un campo Data/ora standard da un altro non costituisce un problema poiché entrambi i campi si trovano nello stesso fuso orario. Quando uno dei valori nel calcolo è una conversione da un valore Testo o Data a un valore Data/Ora, tuttavia, i risultati sono diversi.
Supponiamo che un utente di San Francisco inserisca il valore 00:00 il 2 agosto 2013 in un campo Data/ora personalizzato di nome Date_Time_c. Questo valore è memorizzato come 2013–08–02 07:00:00Z, poiché la differenza di orario nell'ora legale del Pacifico è GMT-7. Alle 12:00 PDT del 1° agosto, l'utente visualizza il record e viene eseguita la seguente formula:
Date_Time_c - NOW()Nel calcolo, NOW() è 2013–08–01 19:00:00Z e quindi sottratto da 2013–08–02 07:00:00Z, per restituire il risultato previsto di 0,5 (12 ore).
Si supponga che, anziché NOW(), la formula converta la stringa "2013–08–01 12:00:00" in un valore Data/ora:
Date_Time_c - DATETIMEVALUE( "2013-08-01 12:00:00" )In questo caso, DATETIMEVALUE(
“2013–08–01 12:00:00” ) è 2013–08–01 12:00:00Z e restituisce un risultato di 0,79167 o 19 ore.
Non vi è modo per determinare il fuso orario di un utente in una formula. Se tutti gli utenti si trovano nello stesso fuso orario, è possibile rettificare la differenza di fuso orario aggiungendo o sottraendo la differenza oraria tra il fuso orario degli utenti e l'ora media di Greenwich ai valori convertiti. Tuttavia, poiché i fusi orari possono essere interessati dall'ora legale e le date di inizio e fine dell'ora legale sono diverse ogni anno, ciò è difficile da gestire in una formula. Si consiglia di utilizzare Apex per le transazioni che richiedono una conversione tra i valori Data/ora e i valori Testo o Data.
