DATEDIFF
返回跨两个指定日期的日期和时间边界数。
一、 语法
DATEDIFF ( datepart , startdate , enddate )
二、参数
datepart
是规定了应在日期的哪一部分计算差额的参数。下表列出了 Microsoft® SQL Server™ 识别的日期部分和缩写。
日期部分 缩写
year yy, yyyy
quarter qq, q
Month mm, m
dayofyear dy, y
Day dd, d
Week wk, ww
Hour hh
minute mi, n
second ss, s
millisecond ms
startdate
是计算的开始日期。startdate 是返回 datetime 或 smalldatetime 值或日期格式字符串的表达式。
因为 smalldatetime 只精确到分钟,所以当用 smalldatetime 值时,秒和毫秒总是 0。
如果您只指定年份的最后两位数字,则小于或等于"两位数年份截止期"配置选项的值的最后两位数字的数字所在世纪与截止年所在世纪相同。大于该选项的值的最后两位数字的数字所在世纪为截止年所在世纪的前一个世纪。例如,如果 two digit year cutoff 为 2049(默认),则 49 被解释为 2049,2050 被解释为 1950。为避免模糊,请使用四位数的年份。
enddate
是计算的终止日期。enddate 是返回 datetime 或 smalldatetime 值或日期格式字符串的表达式。
三、返回类型
integer
四、用法
此函数计算两个指定日期之间日期部分的数目。结果为日期部分中等于(date2 - date1)的有符号的整数值。
当结果不是日期部分的偶数倍时,DATEDIFF 将被截断而不是被舍入。
当使用 day 作为日期部分时,DATEDIFF 返回两个指定的时间之间(包括第二个日期但不包括第一个日期)的午夜数。
当使用 month 作为日期部分时,DATEDIFF 返回两个日期之间(包括第二个日期但不包括第一个日期)出现的月的第一天的数目。
当使用 week 作为日期部分时,DATEDIFF 返回两个日期(包括第二个日期但不包括第一个日期)之间星期日的数目。
对于更小的时间单位存在溢出值:
-
milliseconds 24 天
-
seconds 68 年
-
minutes 4083 年
-
others 没有溢出限制
如果超出这些限制,此函数将返回溢出错误。
五、标准和兼容性
-
SQL/92 Transact-SQL 扩展。
-
SQL/99 Transact-SQL 扩展。
-
Sybase 与 Adaptive Server Enterprise 兼容。
六、示例
下面的语句返回 1:
select datediff( hour, '4:00am', '5:50am' )
下面的语句返回 102:
select datediff( month, '1987/05/02', '1995/11/15' )
下面的语句返回 0:
select datediff( day, '00:00', '23:59' )
下面的语句返回 4:
select datediff( day, '1999/07/19 00:00','1999/07/23 23:59' )
下面的语句返回 0:
select datediff( month, '1999/07/19', '1999/07/23' )
下面的语句返回 1:
select datediff( month, '1999/07/19', '1999/08/23' )