bugl
bugl
HomeLearnPatternsPathsSearchPremium
HomeLearnPatternsPaths

Loading lesson path

Learn/SQL/SQL References
SQL•SQL References

SQL Server DATEDIFF() Function

Example

SELECT DATEDIFF(year, '2017/08/25', '2011/08/25') AS DateDiff;

Definition and Usage

The DATEDIFF() function returns the difference between two dates, as an integer.

Syntax

DATEDIFF(
interval
,
date1
,
date2
)

Parameter Values

ParameterDescription
intervalRequired. The part to return. Can be one of the following values: year, yyyy, yy = Year quarter, qq, q = Quarter month, mm, m = month dayofyear = Day of the year day, dy, y = Day week, ww, wk = Week weekday, dw, w = Weekday hour, hh = hour minute, mi, n = Minute second, ss, s = Second millisecond, ms = Millisecond
date1, date2Required. The two dates to calculate the difference between
  • year, yyyy, yy = Year
  • quarter, qq, q = Quarter
  • month, mm, m = month
  • dayofyear = Day of the year
  • day, dy, y = Day
  • week, ww, wk = Week
  • weekday, dw, w = Weekday
  • hour, hh = hour
  • minute, mi, n = Minute
  • second, ss, s = Second
  • millisecond, ms = Millisecond

Technical Details

Return type:int
Works in:SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

Previous

SQL Server DATEADD() Function

Next

SQL Server DATEFROMPARTS() Function