DATEADD (Transact-SQL)
Actualizado: 14 de abril de 2006
Devuelve un valor datetime nuevo que se obtiene agregando un intervalo a la fecha especificada.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
DATEADD (datepart , number, date )
Argumentos
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.
Tipos de valor devueltos
Devuelve datetime, pero puede devolver smalldatetime si el argumento date es de tipo smalldatetime.
Notas
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.
Ejemplos
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
Vea también
Referencia
CAST y CONVERT (Transact-SQL)
Tipos de datos (Transact-SQL)
Funciones de fecha y hora (Transact-SQL)
Otros recursos
Formato ISO 8601
Formato alfabético de fecha
Formato numérico de fecha
Formato de fecha y hora de ODBC
Formatos de hora
Formato de cadena sin separar
Ayuda e información
Obtener ayuda sobre SQL Server 2005
Historial de cambios
| Versión | Historial |
|---|---|
14 de abril de 2006 |
|