第四十三章 SQL函数 DATEDIFF

Posted 2023-03-05

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

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 调用此函数:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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