totn SQL Server Functions

SQL Server: DATEDIFF Function

This SQL Server tutorial explains how to use the DATEDIFF function in SQL Server (Transact-SQL) with syntax and examples.

Description

In SQL Server (Transact-SQL), the DATEDIFF function returns the difference between two date values, based on the interval specified.

Syntax

The syntax for the DATEDIFF function in SQL Server (Transact-SQL) is:

DATEDIFF( interval, date1, date2 )

Parameters or Arguments

interval

The interval of time to use to calculate the difference between date1 and date2. It can be one of the following values:

Value (any one of) Explanation
year, yyyy, yy Year interval
quarter, qq, q Quarter interval
month, mm, m Month interval
dayofyear Day of year interval
day, dy, y Day interval
week, ww, wk Week interval
weekday, dw, w Weekday interval
hour, hh Hour interval
minute, mi, n Minute interval
second, ss, s Second interval
millisecond, ms Millisecond interval
date1, date2
The two dates to calculate the difference between.

Applies To

The DATEDIFF function can be used in the following versions of SQL Server (Transact-SQL):

  • SQL Server 2017, SQL Server 2016, SQL Server 2014, SQL Server 2012, SQL Server 2008 R2, SQL Server 2008, SQL Server 2005

Example

Let's look at some SQL Server DATEDIFF function examples and explore how to use the DATEDIFF function in SQL Server (Transact-SQL).

For example:

SELECT DATEDIFF(year, '2012/04/28', '2014/04/28');
Result: 2

SELECT DATEDIFF(yyyy, '2012/04/28', '2014/04/28');
Result: 2

SELECT DATEDIFF(yy, '2012/04/28', '2014/04/28');
Result: 2

SELECT DATEDIFF(month, '2014/01/01', '2014/04/28');
Result: 3

SELECT DATEDIFF(day, '2014/01/01', '2014/04/28');
Result: 117

SELECT DATEDIFF(hour, '2014/04/28 08:00', '2014/04/28 10:45');
Result: 2

SELECT DATEDIFF(minute, '2014/04/28 08:00', '2014/04/28 10:45');
Result: 165