Compartir a través de


Función DATEADD en la sintaxis SQL del motor de búsqueda Enterprise Search

Realiza cálculos de hora y fecha para coincidir con las propiedades con tipos de datos.

DATEADD (DateTimeUnits, OffsetValue, DateTime)

Parámetros

Use la función DATEADD para obtener horas y fechas en un intervalo de tiempo especificado anterior al actual.

DateTimeUnits especifica las unidades del parámetro DateTimeValue. Puede ser uno de los siguientes: "YEAR", "QUARTER", "MONTH", "WEEK", "DAY", "HOUR", "MINUTE" o "SECOND". Este valor distingue entre mayúsculas y minúsculas. No es necesario escribir el parámetro entre comillas.

OffsetValue especifica la diferencia de tiempo en las unidades especificadas en el parámetro DateTimeUnits. OffsetValue debe ser un entero negativo. No se admiten los valores positivos.

DateTime es una marca de tiempo desde la que se calcula la diferencia. No puede ser un literal de fecha. Debe ser GETGMTDATE o el resultado de otra función DATEADD.

Comentarios

La función DATEADD sólo se puede usar en comparaciones de valor literal y únicamente en el lado derecho del operador de comparación.

La función GETGMTDATE devuelve la hora y fecha actuales en formato de la hora media de Greenwich (GMT). Recuerde que este valor puede no ser el mismo que el valor de hora local del equipo.

Puede usar varias funciones DATEADD para combinar las unidades de diferencia.

Nota

No use el operador de comparación igual (=) porque la representación interna de tiempo puede producir errores de redondeo que provocarán resultados de coincidencia inesperados.

Ejemplos

La siguiente cláusula WHERE de ejemplo coincide con los documentos modificados en los últimos cinco días:

...WHERE LastModifiedTime <=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 LastModifiedTime <=DATEADD (DAY, -2, DATEADD (HOUR, -4, GETGMTDATE()))

Vea también

Otros recursos

Predicados sin texto completo de la sintaxis SQL del motor de búsqueda Enterprise Search
Comparación de valores literales en la sintaxis SQL del motor de búsqueda Enterprise Search