Función DATEADD
La función DATEADD realiza cálculos de fecha y hora para las propiedades coincidentes que tienen tipos de fecha. Use la función DATEADD para obtener fechas y horas en una cantidad de tiempo especificada antes del presente.
Sintaxis
DATEADD (DateTimeUnits, OffsetValue, DateTime)
Argumentos
DateTimeUnits
Especifica las unidades del parámetro DateTime : YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE o SECOND. Este valor distingue mayúsculas de minúsculas y no se requieren comillas alrededor del parámetro .
OffsetValue
Especifica el desplazamiento de tiempo, en las unidades especificadas por el parámetro DateTimeUnits . OffsetValue debe ser un entero negativo. No se admiten valores positivos.
DateTime
Especifica una marca de tiempo a partir de la cual se va a calcular el desplazamiento. No puede ser un literal de fecha. Debe ser GETGMTDATE o el resultado de otra función DATEADD.
Comentarios
La función DATEADD solo se puede usar en comparaciones de valores literales y solo en el lado derecho del operador de comparación.
La función GETGMTDATE devuelve la fecha y hora actuales en la hora media de Greenwich (GMT). Recuerde que este valor puede no ser el mismo que la hora local del equipo.
No use el operador de comparación equals (=) porque la representación de tiempo interna puede producir errores de redondeo que dan lugar a resultados coincidentes inesperados.
Puede usar varias funciones DATEADD para combinar unidades de desplazamiento.
Ejemplos
La siguiente cláusula WHERE de ejemplo coincide con los documentos modificados en los últimos cinco días:
...WHERE System.DateModified <=DATEADD (DAY, -5, GETGMTDATE())
La cláusula WHERE de ejemplo siguiente coincide con los documentos modificados en los últimos dos días y cuatro horas:
...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))
Temas relacionados
-
Referencia
-
Conceptual