数据库
首页 > 数据库> > 第四十三章 SQL函数 DATEDIFF

第四十三章 SQL函数 DATEDIFF

作者：互联网

文章目录

第四十三章 SQL函数 DATEDIFF

日期/时间函数，返回两个日期之间指定日期部分的整数差。

大纲

DATEDIFF(datepart,startdate,enddate)

参数

描述

DATEDIFF函数返回两个指定日期之间指定日期部分差的整数。日期范围从开始日期开始，到结束日期结束。(如果enddate早于startdate，DATEDIFF将返回一个负整数值。)

DATEDIFF返回startdate和enddate之间指定单位的总数。例如，两个日期时间值之间的分钟数计算日期部分和时间部分，并为每一天的差异增加1440分钟。DATEDIFF返回开始日期和结束日期之间跨越的指定日期部分边界的计数。例如，指定连续年份的任意两个日期(例如2018-09-23和2019-01-01)返回的年份DATEDIFF为1，而不管这两个日期之间的实际持续时间是大于还是小于365天。同样，12:23:59和12:24:05之间的分钟数是1，尽管实际上只有6秒将两个值分开。

请注意，DATEDIFF是为Sybase和Microsoft SQL Server兼容性而提供的。使用TIMESTAMPDIFF ODBC标量函数可以执行类似的时间/日期比较操作。

也可以使用DATEDIFF()方法调用从ObjectScript调用此函数:

$SYSTEM.SQL.Functions.DATEDIFF(datepart,startdate,enddate)

为DATEDIFF()方法指定无效的datepart、startdate或enddate会生成< ZDDIF >错误。

Datepart 参数

日期部分参数可以是下列日期/时间组件之一，可以是全名(日期部分列)或其缩写(缩写列)。这些datepart组件名称和缩写不区分大小写。

Date PartAbbreviations
yearyyyy, yy
monthmm, m
weekwk, ww
weekdaydw
daydd, d
dayofyeardy
hourhh
minutemi, n
secondss, s
millisecondms
microsecondmcs
nanosecondns

weekday和dayofyear datepart值在功能上与day datepart值相同。

DATEDIFF和TIMESTAMPDIFF不处理季度(间隔3个月)。

如果指定包含分数秒的开始日期和结束日期，DATEDIFF将以分数秒的整数形式返回差值，如下例所示:

SELECT DATEDIFF('ms','64701,56670.10','64701,56670.27'),     /* returns 170 */
       DATEDIFF('ms','64701,56670.1111','64701,56670.27222') /* returns 161 */

datepart可以指定为带引号的字符串或不带引号的字符串。这些语法变体执行略有不同的操作:

日期表达式格式

startdate和enddate参数可以采用不同的数据类型格式。

startdate和enddate参数可以采用以下任何格式:

%String(或compatible)值可以是以下任何一种格式，可以包含或省略小数秒:

Sybase/SQL-Server-date是以下五种格式之一:

mm/dd/[yy]yy dd Mmm[mm][,][yy]yy dd [yy]yy Mmm[mm] yyyy Mmm[mm] dd yyyy [dd] Mmm[mm]

在第一种语法格式中，分隔符可以是斜杠(/)、连字符(-)或句点(.)。

Sybase/SQL-Server-time表示以下三种格式之一:

HH:MM[:SS[:FFF]][{AM|PM}] HH:MM[:SS[.FFF]] HH['']{AM|PM}

Years

如果年份以两位数字表示，或者日期被完全省略， IRIS会检查滑动窗口来解释日期。
系统范围内滑动窗口的默认值是1900;
因此，在默认情况下，两位数的年份被认为是在20世纪。
如下示例所示:

SELECT DATEDIFF('year','10/11/14','02/22/2018'),
       DATEDIFF('year','12:00:00','2018-02-22 12:00:00')

在这里插入图片描述

分数秒

DATEDIFF返回以毫秒(3位整数)、微秒(6位整数)或纳秒(9位整数)表示的小数秒，而不管startdate和enddate中的小数位数精度是多少。
如下示例所示:

SELECT DATEDIFF('ms','12:00:00.1','12:00:00.2'),
       DATEDIFF('ms','12:00:00.10009','12:00:00.20007')

在这里插入图片描述

一些NLS区域设置将分数分隔符指定为逗号(欧洲的用法)，而不是句号。
如果当前区域设置是这些区域设置之一，DATEDIFF接受句号或逗号作为本地日期格式的秒分隔符。
对于$HOROLOG格式的日期或ODBC格式的日期，不能使用逗号作为小数秒分隔符。
尝试这样做会生成一个SQLCODE -8。
无论当前的NLS语言环境是什么，这两种格式都需要一段时间。

时间差异与时间格式无关

DATEDIFF返回以秒和毫秒为单位的时间差，即使当前进程的TimeFormat被设置为不返回秒。
如下示例所示:

ClassMethod DateDiff()
{
	s tfmt = ##class(%SYS.NLS.Format).GetFormatItem("TimeFormat")
	d ##class(%SYS.NLS.Format).SetFormatItem("TimeFormat",1)
	w "datetime values (with seconds) are: ",!,
	$ZDATETIME("64701,56670.10",1,-1),"  ",$ZDATETIME("64701,56673.27",1,-1),!
	&sql(SELECT DATEDIFF('ss','64701,56670.10','62871,56673.27') INTO :x)
	w "DATEDIFF number of seconds is: ",x,!!
	d ##class(%SYS.NLS.Format).SetFormatItem("TimeFormat",2)
	w "datetime values (without seconds) are: ",!,
	$ZDATETIME("64701,56670.10",1,-1),"  ",$ZDATETIME("64701,56673.27",1,-1),!
	&sql(SELECT DATEDIFF('ss','64701,56670.10','64701,56673.27') INTO :x)
	w "DATEDIFF number of seconds is: ",x,!
	d ##class(%SYS.NLS.Format).SetFormatItem("TimeFormat",tfmt)
}


DHC-APP>d ##class(PHA.TEST.SQLCommand).DateDiff()
datetime values (with seconds) are:
02/22/2018 15:44:30  02/22/2018 15:44:33
DATEDIFF number of seconds is: -158111996.83
 
datetime values (without seconds) are:
02/22/2018 15:44  02/22/2018 15:44
DATEDIFF number of seconds is: 3.17

范围和值检查

DATEDIFF对输入值执行以下检查:

错误处理

示例

下面的例子返回353，因为两个时间戳之间有353天(D):

SELECT DATEDIFF(D,'2018-01-01 00:00:00','2018-12-20 12:00:00')

353

在下面的示例中，每个DATEDIFF返回1，因为日期的年份部分相差1。
日期之间的实际持续时间不被考虑:

SELECT DATEDIFF('yyyy','1910-08-21','1911-08-21') AS ExactYear,
       DATEDIFF('yyyy','1910-06-30','1911-01-01') AS HalfYear,
       DATEDIFF('yyyy','1910-01-01','1911-12-31') AS Nearly2Years,
       DATEDIFF('yyyy','1910-12-31 11:59:59','1911-01-01 00:00:00') AS NewYearSecond
       
       
1	1	1	1

注意，上面的例子使用了日期部分的缩写。
但是，你可以指定全名，如下例所示:

SELECT DATEDIFF('year','2017-09-10 13:19:00','2018-12-20 00:00:00')

1

下面的嵌入式SQL示例使用主机变量执行与前面示例相同的DATEDIFF操作:

ClassMethod DateDiff1()
{
	s x="year"
	s date1="2017-09-10 13:19:00"
	s date2="2018-12-20 00:00:00"
	&sql(SELECT DATEDIFF(:x,:date1,:date2)
		INTO :diff)
	w diff
}

1

下面的例子使用WHERE子句中的DATEDIFF来选择上周入院的患者:

SELECT Name,DateOfAdmission FROM Sample.Patients WHERE DATEDIFF(D,DateOfAdmission,$HOROLOG) <= 7

下面的例子使用了一个子查询来返回那些个人的出生日期距当前日期不超过1500天的记录:

SELECT Name,Age,DOB
FROM (SELECT Name,Age,DOB, DATEDIFF('dy',DOB,$HOROLOG) AS DaysTo FROM Sample.Person)
WHERE DaysTo <= 1500
ORDER BY Age

在这里插入图片描述

标签：00,12,DATEDIFF,日期,第四十三章,SQL,格式
来源： https://blog.csdn.net/yaoxin521123/article/details/122781136