Funzioni DateAdd, DateDiff e TimeZoneOffset
| Funzione | Si applica a |
|---|---|
| DataAggiungi |  App Canvas Dataverse colonne formula flussi Desktop App basate su modello Power Platform CLI |
| DataDiff | App Canvas Dataverse colonne formula flussi Desktop App basate su modello Power Platform CLI |
| Offset fuso orario | App Canvas Desktop flussi App basate su modello Power Platform CLI |
Aggiunge o trova la differenza nei valori di data/ora ed esegue la conversione tra l'ora locale e l'ora UTC.
Descrizione
La funzione DateAdd aggiunge un numero di unità a un valore di data/ora. Il risultato è un nuovo valore di data/ora. È possibile anche sottrarre un numero di unità da un valore di data/ora specificando un valore negativo.
La funzione DateDiff restituisce la differenza tra due valori di data/ora. Il risultato è un numero intero di unità.
Per entrambe le funzioni, le unità possono essere TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, TimeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters o TimeUnit.Years. Per impostazione predefinita, l'unità usata da entrambe le funzioni è TimeUnit.Days.
La funzione TimeZoneOffset restituisce il numero di minuti tra l'ora locale dell'utente e l'ora UTC (Coordinated Universal Time).
È possibile usare DateAdd con TimeZoneOffset per la conversione tra l'ora locale dell'utente e l'ora UTC (Coordinated Universal Time). L'aggiunta di TimeZoneOffset convertirà un'ora locale nell'ora UTC e la sottrazione (aggiunta del valore negativo) eseguirà la conversione dall'ora UTC all'ora locale.
Vedere anche Tipi di dati Date, Time e DateTime e Utilizzo di date e ore per altre informazioni.
Sintassi
DateAdd( DataOra, Aggiunta [, Unità ] )
- DateTime - Obbligatorio. Valore data/ora su cui eseguire le operazioni.
- Aggiunta - Obbligatorio. Numero da aggiungere a DateTime, in Units.
- Unità - Facoltativo. Tipo di unità da aggiungere: TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, TimeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters o TimeUnit.Years. Se questo argomento non è specificato, viene usato TimeUnit.Days.
DateDiff( StartDateTime, EndDateTime [, Unità ] )
- StartDateTime -obbligatorio. Valore di data/ora iniziale.
- EndDateTime - Obbligatorio. Valore di data/ora finale.
- Unità - Facoltativo. Tipo di unità da sottrarre: TimeUnit.Milliseconds, TimeUnit.Seconds, TimeUnit.Minutes, TimeUnit.Hours, TimeUnit.Days, TimeUnit.Months, TimeUnit.Quarters o TimeUnit.Years. Se questo argomento non è specificato, viene usato TimeUnit.Days.
TimeZoneOffset( [ DataOra ] )
- DateTime - Facoltativo. Valore di data/ora per il quale restituire l'offset. Per impostazione predefinita vengono usati la data e l'ora correnti.
Esempi
In tutti questi esempi si supponga che la data e l'ora correnti siano 15 luglio 2013, 1:02 PM.
DateAdd semplice
| Formula | Descrizione | Risultato |
|---|---|---|
| Testo(DataAggiungi(Ora(), 3), "dd-mm-yyyy hh:mm" ) |
Aggiunge tre giorni (unità predefinite) alla data e all'ora correnti. | "18-07-2013 13:02" |
| Testo( DateAdd( Now(), 4, TimeUnit.Hours ), "dd-mm-yyyy hh:mm" ) |
Aggiungere quattro ore alla data e all'ora correnti. | "15-07-2013 17:02" |
| Testo( DateAdd( Oggi(), 1, TimeUnit.Mesi ), "dd-mm-yyyy hh:mm" ) |
Aggiunge un mese alla data corrente, senza l'ora poiché Today non restituisce un componente ora. | "15-08-2013 00:00" |
| Testo( DateAdd( Now(), ‑30, TimeUnit.Minuti ), "dd-mm-yyyy hh:mm" ) |
Sottrae 30 minuti dalla data e dall'ora correnti. | "15-07-2013 12:32" |
DateDiff semplice
| Formula | Descrizione | Risultato |
|---|---|---|
| DateDiff( Adesso(), DateValue("1/1/2014") ) | Restituisce la differenza tra le due unità nelle unità di misura predefinite TimeUnit.Days | 170 |
| DateDiff( Ora(), DateValue("1/1/2014"), TimeUnit.Mesi ) | Restituisce la differenza tra i due valori in TimeUnit.Months | 6 |
| DateDiff( Ora(), Oggi(), TimeUnit.Minuti ) | Restituisce la differenza tra la data e l'ora correnti e solo la data corrente (non l'ora), in minuti. Poiché il valore Now è successivo a Today il risultato sarà negativo. | -782 |
Differenza di date con risultati frazionari
La funzione DateDiff restituisce solo un numero intero delle unità sottratte e la precisione è data nell'unità specificata. Per calcolare la differenza con una precisione maggiore, utilizza un'unità più piccola e converti il risultato in modo appropriato, come negli esempi seguenti.
| Formula | Descrizione | Risultato |
|---|---|---|
| DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Ore ) | I minuti/secondi vengono ignorati, la differenza è basata sul tempo arrotondato all'ora. | 1 |
| DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Minuti )/60 | I minuti vengono utilizzati nella differenza e il risultato viene diviso per 60 per avere la differenza in ore. | 0.5 |
| DateDiff( TimeValue("09:45:00"), TimeValue("10:15:36"), TimeUnit.Secondi )/3600 | I minuti e i secondi vengono utilizzati nella differenza e il risultato viene diviso per 3600 per avere la differenza in ore. | 0.51 |
Conversione in formato UTC
Per convertire in formato UTC (Coordinated Universal Time), aggiungere TimeZoneOffset per il tempo specificato.
Si supponga, ad esempio, che la data e l'ora correnti siano 15 luglio 2013, 1:02 PM nell'ora legale Pacifico (PDT, UTC-7). Per determinare l'ora corrente in formato UTC, usare:
- DateAdd( Ora(), TimeZoneOffset(), TimeUnit.Minuti )
TimeZoneOffset per impostazione predefinita è l'ora corrente, quindi non è necessario passargli un argomento.
Per visualizzare il risultato, usare la funzione Text con il formato dd-mm-yyyy hh:mm, che restituirà 15-07-2013 20:02.
Conversione dal formato UTC
Per eseguire la conversione dal formato UTC, sottrarre TimeZoneOffset, aggiungendo il corrispondente negativo, per il tempo specificato.
Si supponga, ad esempio, che la data e l'ora UTC 15 luglio 2013, 8:02 PM vengano archiviate in una variabile denominata StartTime. Per modificare l'ora per il fuso orario dell'utente, usare:
- DateAdd( Ora di inizio, −TimeZoneOffset( Ora di inizio ), TimeUnit.Minuti )
Si noti il segno negativo prima di TimeZoneOffset per sottrarre l'offset anziché aggiungerlo.
Per visualizzare il risultato, usare la funzione Text con il formato dd-mm-yyyy hh:mm, che restituirà 15-07-2013 13:02 se ci si trova in un fuso orario del Pacifico.