Funciones DateAdd, DateDiff y TimeZoneOffset de Power AppsDateAdd, DateDiff, and TimeZoneOffset functions in Power Apps

Agrega valores de fecha y hora o encuentra la diferencia en estos valores y realiza la conversión entre la hora local y UTC.Adds to or finds the difference in date/time values and converts between local time and UTC.

DescripciónDescription

La función DateAdd agrega un número de unidades a un valor de fecha y hora.The DateAdd function adds a number of units to a date/time value. El resultado es un nuevo valor de fecha y hora.The result is a new date/time value. También puede restar un número de unidades de un valor de fecha y hora mediante la especificación de un valor negativo.You can also subtract a number of units from a date/time value by specifying a negative value.

La función DateDiff devuelve la diferencia entre dos valores de fecha y hora.The DateDiff function returns the difference between two date/time values. El resultado es un número de unidades.The result is a number of units.

En ambas funciones, las unidades pueden ser Milisegundos, Segundos, Minutos, Horas, Días, Meses, Trimestres o Años.For both functions, units can be Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. De forma predeterminada, ambas funciones usan días como unidades.By default, both functions use Days as units.

La función TimeZoneOffset devuelve el número de minutos entre la hora local del usuario y la Hora universal coordinada (UTC).The TimeZoneOffset function returns the number of minutes between the user's local time and UTC (Coordinated Universal Time).

Puede usar DateAdd con TimeZoneOffset para realizar la conversión entre la hora local del usuario y la Hora universal coordinada (UTC).You can use DateAdd with the TimeZoneOffset to convert between the user's local time and UTC (Coordinated Universal Time). Al sumar TimeZoneOffset se convierte la hora local a UTC y al restarlo (agregar el signo negativo) se convierte de UTC a la hora local.Adding TimeZoneOffset will convert a local time to UTC, and subtracting it (adding the negative) will convert from UTC to local time.

Para obtener más información, consulte también las secciones sobre los tipos de datos Date, Time y DateTime, y sobre cómo trabajar con Date y Time.Also see Date, Time, and DateTime data types and working with dates and times for more information.

SintaxisSyntax

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

  • DateTime: requerido.DateTime - Required. Valor de fecha y hora con el que operar.Date/time value to operate on.
  • Suma: requerido.Addition - Required. Número, en unidades, para agregar a DateTime.Number, in Units, to add to the DateTime.
  • Unidades: opcional.Units - Optional. El tipo de unidades para agregar: Milisegundos, Segundos, Minutos, Horas, Días, Meses, Trimestres o Años.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Si no se especifica, se usará Días.If not specified, Days are used.

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

  • StartDateTime: requerido.StartDateTime - Required. Valor de fecha y hora de inicio.Starting date/time value.
  • EndDateTime: requerido.EndDateTime - Required. Valor de fecha y hora de finalización.Ending date/time value.
  • Unidades: opcional.Units - Optional. El tipo de unidades para agregar: Milisegundos, Segundos, Minutos, Horas, Días, Meses, Trimestres o Años.The type of Units to add: Milliseconds, Seconds, Minutes, Hours, Days, Months, Quarters, or Years. Si no se especifica, se usará Días.If not specified, Days are used.

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

  • DateTime: opcional.DateTime - Optional. Valor de fecha y hora para el que se devuelve el desplazamiento.Date/time value for which to return the offset. De forma predeterminada, se utiliza la fecha y hora actuales.By default, the current date/time is used.

Ejemplos:Examples

En todos estos ejemplos, se supone que la fecha y hora actuales son 15 de julio de 2013, 1:02 p.m.In all of these examples, assume that the current date and time is July 15, 2013, 1:02 PM.

DateAdd simpleSimple DateAdd

FórmulaFormula DescripciónDescription ResultadoResult
Text( DateAdd( Now(); 3 );
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(); 3 );
"dd-mm-yyyy hh:mm" )
Agrega tres días (unidades predeterminadas) a la fecha y hora actuales.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 );
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(); 4; Hours );
"dd-mm-yyyy hh:mm" )
Agrega cuatro horas a la fecha y hora actuales.Add four hours to the current date and time. "15-07-2013 17:02""15-07-2013 17:02"
Text( DateAdd( Today(); 1; Months );
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Today(); 1; Months );
"dd-mm-yyyy hh:mm" )
Agrega un mes a la fecha actual, sin tiempo dado que Today no devuelve un componente de tiempo.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 );
"dd-mm-yyyy hh:mm" )
Text( DateAdd( Now(); ‑;30; Minutes );
"dd-mm-yyyy hh:mm" )
Resta 30 minutos de la fecha y hora actuales.Subtracts 30 minutes from the current date and time. "15-07-2013 12:32""15-07-2013 12:32"

DateDiff simpleSimple DateDiff

FórmulaFormula DescripciónDescription ResultadoResult
DateDiff( Now(); DateValue("1/1/2014") )DateDiff( Now(); DateValue("1/1/2014") ) Devuelve la diferencia entre las dos unidades en las unidades predeterminadas de Días.Returns 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 ) Devuelve la diferencia entre los dos valores en Meses.Returns the difference between the two values in Months 66
DateDiff( Now(); Today(); Minutes )DateDiff( Now(); Today(); Minutes ) Devuelve la diferencia entre la fecha y hora actuales y la fecha actual solamente (ninguna hora) en minutos.Returns the difference between the current date/time and the current date only (no time) in minutes. Puesto que Now es posterior a Today, el resultado es negativo.Since the Now is later than Today the result will be negative. -782-782

Conversión a UTCConverting to UTC

Para convertir a UTC (Hora universal coordinada), agregue TimeZoneOffset durante el tiempo especificado.To convert to UTC (Coordinated Universal Time), add the TimeZoneOffset for the given time.

Imagine, por ejemplo, que los valores de fecha y hora actuales son 15 de julio de 2013, 1:02 p.m. en la Hora de verano del Pacífico (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). Para determinar la hora actual en hora UTC, use:To determine the current time in UTC, use:

  • DateAdd( Now(); TimeZoneOffset(); Minutes )DateAdd( Now(); TimeZoneOffset(); Minutes )

TimeZoneOffset toma como valor predeterminado la hora actual, por lo que no es necesario pasarle un argumento.TimeZoneOffset defaults to the current time, so you don't need to pass it an argument.

Para ver el resultado, use la función Text con el formato dd-mm-aaaa hh:mm, que devolverá 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.

Conversión desde UTCConverting from UTC

Para convertir desde UTC, reste TimeZoneOffset (agregando el signo negativo) para la hora especificada.To convert from UTC, subtract the TimeZoneOffset (by adding the negative) for the given time.

Imagine, por ejemplo, que los valores de fecha y hora UTC 15 de julio de 2013, 8:02 p.m. se almacenan en una variable llamada StartTime.For example, imagine the UTC date and time July 15, 2013, 8:02 PM is stored in a variable named StartTime. Para ajustar la hora de la zona horaria del usuario, use:To adjust the time for the user's time zone, use:

  • DateAdd( StartTime; −TimeZoneOffset( StartTime ); Minutes )DateAdd( StartTime; −TimeZoneOffset( StartTime ); Minutes )

Tenga en cuenta el signo negativo delante de TimeZoneOffset para restar el desplazamiento en lugar de sumarlo.Note the negative sign before TimeZoneOffset to subtract the offset rather than add it.

Para ver el resultado, use la función Text con el formato dd-mm-aaaa hh:mm, que devuelve 15-07-2013 13:02 en la Hora de verano del Pacífico.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.