Funzioni DateAdd, DateDiff e TimeZoneOffset in PowerAppsDateAdd, DateDiff, and TimeZoneOffset functions in PowerApps

Aggiunge o trova la differenza nei valori di data/ora ed esegue la conversione tra l'ora locale e l'ora UTC.Adds to or finds the difference in date/time values and converts between local time and UTC.

DescrizioneDescription

La funzione DateAdd aggiunge un numero di unità a un valore di data/ora.The DateAdd function adds a number of units to a date/time value. Il risultato è un nuovo valore di data/ora.The result is a new date/time value. È possibile anche sottrarre un numero di unità da un valore di data/ora specificando un valore negativo.You can also subtract a number of units from a date/time value by specifying a negative value.

La funzione DateDiff restituisce la differenza tra due valori di data/ora.The DateDiff function returns the difference between two date/time values. Il risultato è un numero di unità.The result is a number of units.

Per entrambe le funzioni, le unità possono essere millisecondi, secondi, minuti, ore, giorni, mesi, trimestri o anni.For both functions, units can be Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Per impostazione predefinita, l'unità usata da entrambe le funzioni è Days.By default, both functions use Days as units.

La funzione TimeZoneOffset restituisce il numero di minuti tra l'ora locale dell'utente e l'ora UTC (Coordinated Universal Time).The TimeZoneOffset function returns the number of minutes between the user's local time and 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).You can use DateAdd with the TimeZoneOffset to convert between the user's local time and 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.Adding TimeZoneOffset will convert a local time to UTC, and subtracting it (adding the negative) will convert from UTC to local time.

Per altre informazioni, vedere Working with dates and times (Uso di date e ore).Also see working with dates and times for more information.

SintassiSyntax

DateAdd( DateTime, Addition [, Units ] )DateAdd( DateTime, Addition [, Units ] )

  • DataOra: obbligatorio.DateTime - Required. Valore di data/ora su cui eseguire le operazioni.Date/time value to operate on.
  • Addition: obbligatorio.Addition - Required. Numero da aggiungere a DateTime, in Units.Number, in Units, to add to the DateTime.
  • Units: facoltativo.Units - Optional. Il tipo di unità da aggiungere: millisecondi, secondi, minuti, ore, giorni, mesi, trimestri o anni.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Se questo argomento non è specificato, viene usato Days.If not specified, Days are used.

DateDiff( StartDateTime, EndDateTime [, Units ] )DateDiff( StartDateTime, EndDateTime [, Units ] )

  • StartDateTime: obbligatorio.StartDateTime - Required. Valore di data/ora iniziale.Starting date/time value.
  • EndDateTime: obbligatorio.EndDateTime - Required. Valore di data/ora finale.Ending date/time value.
  • Units: facoltativo.Units - Optional. Il tipo di unità da aggiungere: millisecondi, secondi, minuti, ore, giorni, mesi, trimestri o anni.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Se questo argomento non è specificato, viene usato Days.If not specified, Days are used.

TimeZoneOffset( [ DateTime ] )TimeZoneOffset( [ DateTime ] )

  • DateTime: facoltativo.DateTime - Optional. Valore di data/ora per il quale restituire l'offset.Date/time value for which to return the offset. Per impostazione predefinita vengono usati la data e l'ora correnti.By default, the current date/time is used.

EsempiExamples

In tutti questi esempi si supponga che la data e l'ora correnti siano 15 luglio 2013, 1:02 PM.In all of these examples, assume that the current date and time is July 15, 2013, 1:02 PM.

DateAdd sempliceSimple DateAdd

FormulaFormula DescrizioneDescription RisultatoResult
Text( DateAdd( Now(), 3 ),
"gg-mm-aaaa hh:mm" )
Text( DateAdd( Now(), 3 ),
"dd-mm-yyyy hh:mm" )
Aggiunge tre giorni (unità predefinite) alla data e all'ora correnti.Adds three days (default units) to the current date and time. "18-07-2013 13:02""18-07-2013 13:02"
Text( DateAdd( Now(), 4, Hours ),
"gg-mm-aaaa hh:mm" )
Text( DateAdd( Now(), 4, Hours ),
"dd-mm-yyyy hh:mm" )
Aggiungere quattro ore alla data e all'ora correnti.Add four hours to the current date and time. "15-07-2013 17:02""15-07-2013 17:02"
Text( DateAdd( Today(), 1, Months ),
"gg-mm-aaaa hh:mm" )
Text( DateAdd( Today(), 1, Months ),
"dd-mm-yyyy hh:mm" )
Aggiunge un mese alla data corrente, senza l'ora poiché Today non restituisce un componente ora.Adds one month to the current date, without time as Today doesn't return a time component. "15-08-2013 00:00""15-08-2013 00:00"
Text( DateAdd( Now(), ‑30, Minutes ),
"gg-mm-aaaa hh:mm" )
Text( DateAdd( Now(), ‑30, Minutes ),
"dd-mm-yyyy hh:mm" )
Sottrae 30 minuti dalla data e dall'ora correnti.Subtracts 30 minutes from the current date and time. "15-07-2013 12:32""15-07-2013 12:32"

DateDiff sempliceSimple DateDiff

FormulaFormula DescrizioneDescription RisultatoResult
DateDiff( Now(), DateValue("1/1/2014") )DateDiff( Now(), DateValue("1/1/2014") ) Restituisce la differenza tra le due unità nelle unità di misura predefinite di GiorniReturns the difference between the two units in the default units of Days 170170
DateDiff( Now(), DateValue("1/1/2014"), Months )DateDiff( Now(), DateValue("1/1/2014"), Months ) Restituisce la differenza tra i due valori in MesiReturns the difference between the two values in Months 66
DateDiff( Now(), Today(), Minutes )DateDiff( Now(), Today(), Minutes ) Restituisce la differenza tra la data e l'ora correnti e solo la data corrente (non l'ora), in minuti.Returns the difference between the current date/time and the current date only (no time) in minutes. Poiché il valore Now è successivo a Today il risultato sarà negativo.Since the Now is later than Today the result will be negative. -782-782

Conversione in formato UTCConverting to UTC

Per convertire in formato UTC (Coordinated Universal Time), aggiungere TimeZoneOffset per il tempo specificato.To convert to UTC (Coordinated Universal Time), add the TimeZoneOffset for the given time.

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).For example, imagine the current date and time is July 15, 2013, 1:02 PM in Pacific Daylight Time (PDT, UTC-7). Per determinare l'ora corrente in formato UTC, usare:To determine the current time in UTC, use:

  • DateAdd( Now(), TimeZoneOffset(), Minutes )DateAdd( Now(), TimeZoneOffset(), Minutes )

TimeZoneOffset usa come impostazione predefinita l'ora corrente e non è quindi necessario passare un argomento.TimeZoneOffset defaults to the current time, so you don't need to pass it an argument.

Per visualizzare il risultato, usare la funzione Text con il formato gg-mm-aaaa hh: mm, che restituirà 15-07-2013 20:02.To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will return 15-07-2013 20:02.

Conversione dal formato UTCConverting from UTC

Per eseguire la conversione dal formato UTC, sottrarre TimeZoneOffset, aggiungendo il corrispondente negativo, per il tempo specificato.To convert from UTC, subtract the TimeZoneOffset (by adding the negative) for the given time.

Si supponga, ad esempio, che la data e l'ora UTC 15 luglio 2013, 8:02 PM vengano archiviate in una variabile denominata StartTime.For example, imagine the UTC date and time July 15, 2013, 8:02 PM is stored in a variable named StartTime. Per modificare l'ora per il fuso orario dell'utente, usare:To adjust the time for the user's time zone, use:

  • DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )DateAdd( StartTime, -TimeZoneOffset( StartTime ), Minutes )

Si noti il segno negativo prima di TimeZoneOffset per sottrarre l'offset anziché aggiungerlo.Note the negative sign before TimeZoneOffset to subtract the offset rather than add it.

Per visualizzare il risultato, usare la funzione Text con il formato gg-mm-aaaa hh:mm, che restituirà 15-07-2013 13:02 se ci si trova in un fuso orario del Pacifico.To see the result, use the Text function with the format dd-mm-yyyy hh:mm, which will result in 15-07-2013 13:02 if you're in Pacific Daylight Time.