Compartir vía


Función DATEADD

La función DATEADD realiza cálculos de fecha y hora para que las propiedades coincidentes tengan 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 de

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 desde la que se va a calcular el desplazamiento. No puede ser un literal de fecha. Debe ser GETGMTDATE o el resultado de otra función DATEADD.

Observaciones

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 siguiente cláusula WHERE de ejemplo coincide con los documentos modificados en los últimos dos días y cuatro horas:

...WHERE System.DateModified <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

de referencia de

comparación de valores literales de

comparaciones multivalor (ARRAY)

conceptual de

predicados deFull-Text

predicados noFull-Text