DATEADD (SSIS)
Devuelve un nuevo valor de tipo DT_DBTIMESTAMP tras agregar un número que representa una fecha o un intervalo de tiempo a la parte de fecha especificada de una fecha determinada. La evaluación del parámetro number debe devolver un entero y la del parámetro date debe devolver una fecha válida.
Sintaxis
DATEADD(datepart, number, date)
Argumentos
datepart
Parámetro que especifica a qué parte de la fecha se agregará un número.number
Valor que se utiliza para incrementar datepart. El valor debe ser de tipo entero y debe conocerse al analizar la expresión.date
Expresión que devuelve una fecha válida o una cadena con formato de fecha.
Tipos de resultado
DT_DBTIMESTAMP
Notas
En la tabla siguiente se incluyen las partes de fecha y las abreviaturas reconocidas por el evaluador de expresiones. En los nombres de partes de fecha no se distinguen mayúsculas de minúsculas.
Parte de la fecha |
Abreviaturas |
|---|---|
Year (Año) |
yy, yyyy |
Quarter (Trimestre) |
qq, q |
Month (Mes) |
mm, m |
Dayofyear (Día del año) |
dy, y |
Day (Día) |
dd, d |
Week (Semana) |
wk, ww |
Weekday (Día de la semana) |
dw, w |
Hour (Hora) |
Hh |
Minute (Minuto) |
mi, n |
Second (Segundo) |
ss, s |
Millisecond (Milisegundo) |
Ms |
El argumento number debe estar disponible al analizar la expresión. Puede ser una constante o una variable. No pueden usarse valores de columnas porque estos valores no se conocen en el momento de analizar la expresión.
El argumento datepart debe entrecomillarse.
Un literal de tipo fecha debe convertirse explícitamente a cualquiera de los tipos de datos de fecha. Para obtener más información, vea Tipos de datos de Integration Services.
[!NOTA]
La expresión no puede validarse cuando un literal de fecha se convierte explícitamente en uno de estos tipos de datos de fecha: DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 y DT_DBTIME2.
DATEADD devuelve un resultado NULL si el valor del argumento es NULL.
Se producirán errores si la fecha no es válida, si la fecha o la hora no se indican mediante una cadena o si el incremento no es un entero estático.
Ejemplos
Este ejemplo agrega un mes a la fecha actual.
DATEADD("Month", 1,GETDATE())
Este ejemplo agrega 21 días a las fechas de la columna ModifiedDate.
DATEADD("day", 21, ModifiedDate)
Este ejemplo agrega 2 años a un literal de fecha.
DATEADD("yyyy", 2, (DT_DBTIMESTAMP)"8/6/2003")
Vea también