DATEADD (Transact-SQL)

Actualizado: 14 de abril de 2006

Devuelve un valor datetime nuevo que se obtiene agregando un intervalo a la fecha especificada.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL


DATEADD (datepart , number, date )

datepart

Es el parámetro que especifica en qué parte de la fecha se devuelve un nuevo valor. En la tabla siguiente se incluyen las partes de fecha y las abreviaturas reconocidas por Microsoft SQL Server 2005.

Parte de la fecha Abreviaturas

year

yy, yyyy

quarter

qq, q

month

mm, m

dayofyear

dy, y

day

dd, d

week

wk, ww

weekday

dw, w

hour

hh

minute

mi, n

second

ss, s

millisecond

ms

number

Valor que se utiliza para incrementar datepart. Si especifica un valor que no sea un entero, se descarta la parte decimal del valor. Por ejemplo, si se especifica day para datepart y 1,75 para number, date se incrementa en 1.

date

Es una expresión que devuelve un valor datetime o smalldatetime, o una cadena de caracteres con formato de fecha. Para obtener información sobre cómo especificar fechas, vea Date y Time (Transact-SQL).

Si especifica sólo los dos últimos dígitos del año, los valores menores o iguales que los dos últimos dígitos del valor de la opción de configuración two digit year cutoff pertenecen al mismo siglo que el año límite. Los valores mayores que los dos últimos dígitos del valor de esta opción pertenecen al siglo anterior al año límite. Por ejemplo, si two-digit year cutoff es 2049 (valor predeterminado), 49 se interpreta como 2049 y 50 se interpreta como 1950. Para evitar ambigüedades, utilice años de cuatro dígitos.

Devuelve datetime, pero puede devolver smalldatetime si el argumento date es de tipo smalldatetime.

Cuando datepart es mes, el número de días del mes afecta al resultado. Por ejemplo, agosto tiene 31 días y septiembre tiene 30 días. Las dos instrucciones siguientes devuelven 2006-09-30 00:00:00.000.

SELECT DATEADD(month, 1, '08/30/2006')
SELECT DATEADD(month, 1, '08/31/2006')

Es decir, al agregar un mes al final de agosto, se devuelve el último día de septiembre.

En el siguiente ejemplo se imprime una lista de un margen de tiempo para los pedidos de la base de datos AdventureWorks. Este margen de tiempo representa la fecha del pedido existente más 21 días.

USE AdventureWorks;
GO
SELECT DATEADD(day, 21, OrderDate)AS TimeFrame 
FROM Sales.SalesOrderHeader;
GO

Versión Historial

14 de abril de 2006

Contenido nuevo:
  • Se ha agregado la sección Notas.

Adiciones de comunidad

AGREGAR
Mostrar: