SQL DATEDIFF函数

目录

描述

语法

SQL DATEDIFF使用说明

SQL DATEDIFF示例

---

描述

使用SQL DATEDIFF根据指定的日期部分返回两个日期之间的差异。该DATDIFF函数将此差值作为整数值返回。

该DATEDIFF函数返回两个日期之间的年数、月数、周数或天数。

DATEDIFF的一般形式是

DATEDIFF(date part, start value, end value)

其中date part对应于预定义日期部分的列表，例如年、月、周和日。

计算起始值和结束值之间的差值。

这个函数可能看起来有点复杂，但它在SQL中有很多实际用途，因此非常值得理解。

您可以使用它来计算账单逾期的天数，或两个日期之间的天数或周数。

考虑这个例子：

人力资源副总裁希望向所有员工颁发多年服务奖。她希望您制作一份所有服务超过十年的员工的报告。

为此，我们将使用该DATEDIFF报告来显示服务年数并过滤掉服务年限少于十年的人。

这是SQL

SELECT   NationalIDNumber,
         HireDate,
         DATEDIFF(year, HireDate, GETDATE()) YearsOfService
FROM     HumanResources.Employee
WHERE    DATEDIFF(year, HireDate, GETDATE()) >= 10
ORDER BY YearsOfService DESC

这里是结果

 

DATEDIFF结果

语法

DATADIFF ( datepart, startdate, enddate )。

SQL DATEDIFF使用说明

• 作为第一个参数的datepart指示SQL DATEDIFF函数作为开始日期和结束日期之间的差值返回的值类型。日期部分参数的有效值列表包括年、月、日等。这些值也可以是缩写，例如yy表示一年，mm表示一个月。
• 作为最后两个参数的开始日期和结束日期可以是date、datetime、datetimeoffset、datetime2、samlldatetime和time数据类型。
• 该DATEDIFF函数的返回类型是一个int，表示开始日期和结束日期之间的差异。
• 如果日期部分是日期，则SQL DATEDIFF函数将日期的时间部分设置为00:00:00。当指定为时间时，该DATEDIFF函数将缺少的日期部分设置为1900-01-01。
• 如果开始日期和结束日期中的任何一个具有比另一个更多的时间部分，DATADIFF则将较小值的缺失部分设置为零。
• 当日期值作为字符串传递时，SQL DATADIFF函数不支持YDM格式，因为它将文字字符串转换为datetime2数据类型。因此，日期值必须首先转换为datetime或smalldatetime数据类型，而不是作为字符串值传递。

SQL DATEDIFF示例

我们将使用Adventureworks2019数据库进行以下查询。

/* Answer */
SELECT DATEDIFF(MINUTE, '2021/05/01 06:00', '2021/05/01 11:14') AS DateDiffResult;

以下示例是一个简单的SQL DATEDIFF查询，以分钟为单位计算两个日期值之间的差异。

在下一个示例中，我们通过将SQL DATEDIFF函数应用于SalesOrderHeader表的OrderDate和DueDate列来计算订单交付的剩余天数。

/* Answer */
SELECT SalesOrderID, OrderDate, DueDate, DATEDIFF(day, OrderDate, DueDate) DaysLeft
FROM Sales.SalesOrderHeader

接下来，让我们将SQL DATEDIFF函数与聚合函数一起应用。对于每个职位，查询都会计算员工工作的最大年数。

/* Answer */
SELECT  JobTitle, DATEDIFF(year, MAX(HireDate), SYSDATETIME()) AS YearsEmployed
FROM HumanResources.Employee  
GROUP BY JobTitle

上面的查询显示了职位和员工在该职位下工作的最大年数。MAX函数根据Group By子句指示的每个职位选择最大日期值。SYSDATETIME返回当前时间。在这里，SQL DATEDIFF计算雇用日期和当前时间之间的差异。

本文最初发布于SQL DATEDIFF Function (Transact SQL) - Essential SQL

https://www.codeproject.com/Articles/5326808/SQL-DATEDIFF-Function