bugl
bugl
HomeLearnPatternsSearch
HomeLearnPatternsSearch

Loading lesson path

Learn/SQL/SQL References
SQL•SQL References

SQL Server DATEDIFF() Function

Concept visual

SQL Server DATEDIFF() Function

Pointer walk
two pointers
leftright102132436485116
left=0
right=6
1
3

Start at both ends

Example

Return the difference between two date values, in years:

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

Parameter

Description interval

Required. 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, date2 Required. The two dates to calculate the difference between

Technical Details

Return type:

int

Works in:

SQL Server (starting with 2008), Azure SQL Database, Azure SQL Data Warehouse, Parallel Data Warehouse

More Examples

Example

Return the difference between two date values, in months: SELECT DATEDIFF(month, '2017/08/25',

'2011/08/25') AS DateDiff;

Example

Return the difference between two date values, in hours: SELECT DATEDIFF(hour, '2017/08/25 07:00', '2017/08/25 12:45') AS DateDiff;

Previous

❮ SQL Server Functions

Next

Previous

SQL Server DATEADD() Function

Next

SQL Server DATEFROMPARTS() Function