DATEDIFF (expresión de SSIS)

  • Artículo

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

Devuelve el número de límites de fecha y hora entre dos fechas especificadas. El parámetro datepart identifica los límites de fecha y hora que se van a comparar.

Sintaxis

  
DATEDIFF(datepart, startdate, endate)

Argumentos

datepart
Parámetro que especifica la parte de la fecha que se va a comparar y para la que se devuelve un valor.

startdate
Fecha de inicio del intervalo.

endate
Fecha de finalización del intervalo.

Tipos de resultado

DT_I4

Observaciones

En la tabla siguiente se incluyen las partes de fecha y las abreviaturas reconocidas por el evaluador de expresiones.

parte de fecha Abreviaturas
Year yy, yyyy
Quarter (Trimestre) qq, q
Month mm, m
Dayofyear dy, y
Día dd, d
Semana wk, ww
Día de la semana dw, w
Hora Hh
Minute mi, n
Second ss, s
Millisecond Ms

DATEDIFF devuelve un resultado NULL si alguno de los argumentos es NULL.

Un literal de tipo fecha debe convertirse explícitamente en uno de los tipos de datos de fecha. Para obtener más información, vea Integration Services Data Types.

Se produce un error si una fecha no es válida, si la fecha o unidad de tiempo no es una cadena, si la fecha de inicio no es una fecha o si la fecha de finalización no es una fecha.

Si la fecha de finalización es anterior a la fecha de inicio, la función devuelve un número negativo. Si las fechas de inicio y de finalización coinciden o están dentro del mismo intervalo, la función devuelve cero.

Ejemplos de expresiones de SSIS

Este ejemplo calcula el número de días entre dos literales de fecha. Si la fecha tiene el formato "mm/dd/aaaa", la función devuelve 7.

DATEDIFF("dd", (DT_DBTIMESTAMP)"8/1/2003", (DT_DBTIMESTAMP)"8/8/2003")

Este ejemplo devuelve el número de meses entre un literal de fecha y la fecha actual.

DATEDIFF("mm", (DT_DBTIMESTAMP)"8/1/2003",GETDATE())

Este ejemplo devuelve el número de semanas entre la fecha de la columna ModifiedDate y la variable YearEndDate . Si YearEndDate tiene el tipo de datos date , no es necesario realizar una conversión explícita.

DATEDIFF("Week", ModifiedDate,@YearEndDate)

Vea también

DATEADD (expresión de SSIS)
DATEPART (expresión de SSIS)
DAY (expresión de SSIS)
MONTH (expresión de SSIS)
YEAR (expresión de SSIS)
Funciones (expresión de SSIS)