La función DATEDIFF devuelve la diferencia en la escala que se indique entre dos fechas.
DATEDIFF(
start_date,
end_date,
interval
)
- start_date: Fecha de comienzo en formato datetime.
- end_date: Fecha final en formato datetime.
- interval: Intervalo a usar para el cálculo. Puede tomar cualquiera de los siguientes valores:
- SECOND
- MINUTE
- HOUR
- DAY
- WEEK
- MONTH
- QUARTER
- YEAR
La función DATEDIFF devuelve un número entero indicando la diferencia en la escala especificada entre dos fechas.
Es importante destacar que la función devuelve la diferencia entre las dos fechas (el número de intervalos de diferencia), no el número de intervalos cubiertos (que puede ser mayor). Así, la diferencia entre el 31 de diciembre de 2015 y el 1 de enero de 2017 no son tres años (aun cuando la primera fecha es de 2015 y la última 2017), sino dos años (que es la diferencia entre 2017 y 2015):
El argumento interval se escribe sin comillas.
El siguiente ejemplo compara la fecha del 31 de diciembre de 2015 a las 23:59:59 con el 1 de enero de 2016 a las 0:0:0 (un segundo después). Como puede verse, la diferencia entre ambas fechas según todos los intervalos (salvo para la semana) es 1:
En este ejemplo se muestra el número de semanas transcurridas desde la fecha de venta hasta el día de hoy (cálculo que implica las funciones DATEDIFF y TODAY):
