大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:MICROSECONDS_DIFF

· 52CE 我爱测

MICROSECONDS_DIFF 函数用于计算两个日期时间值之间的微秒差值,结果为结束时间减去开始时间所得的完整微秒数。该函数支持 DATETIME 和 TIMESTAMP_NS,也支持两种类型混合输入。

描述

MICROSECONDS_DIFF 函数用于计算两个日期时间值之间的微秒差值,结果为结束时间减去开始时间所得的完整微秒数。该函数支持 DATETIME 和 TIMESTAMP_NS,也支持两种类型混合输入。

语法

MICROSECONDS_DIFF(`<date_or_time_expr1>`, `<date_or_time_expr2>`)

参数

参数 说明
<date_or_time_expr1> 结束时间,类型为 DATETIME 或 TIMESTAMP_NS。支持的格式请参见 DATETIME 的转换和 TIMESTAMP_NS 的转换。
<date_or_time_expr2> 开始时间,类型为 DATETIME、TIMESTAMP_NS 或符合格式的日期时间字符串。

返回值

返回类型为 BIGINT,表示两个时间之间的微秒差值。

  • 如果 <date_or_time_expr1> 大于 <date_or_time_expr2>,返回正数
  • 如果 <date_or_time_expr1> 小于 <date_or_time_expr2>,返回负数
  • 1 秒 = 1,000,000 微秒
  • 若两个时间完全相同(包括微秒部分),返回 0。
  • 不足一个完整微秒的剩余纳秒会向零截断。如需精确的纳秒差值,请使用 NANOSECONDS_DIFF。
  • 若任一参数为 NULL,返回 NULL。

举例


---计算两日期时间的微妙差
SELECT MICROSECONDS_DIFF('2020-12-25 21:00:00.623000','2020-12-25 21:00:00.123000');
+------------------------------------------------------------------------------+
| MICROSECONDS_DIFF('2020-12-25 21:00:00.623000','2020-12-25 21:00:00.123000') |
+------------------------------------------------------------------------------+
|                                                                       500000 |
+------------------------------------------------------------------------------+

---结束时间早于开始时间,返回负数
SELECT MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01 12:00:00.800000');
+-------------------------------------------------------------------------------+
| MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01 12:00:00.800000') |
+-------------------------------------------------------------------------------+
|                                                                       -300000 |
+-------------------------------------------------------------------------------+

--- TIMESTAMP_NS 可按纳秒精度比较;不足一个微秒的部分会被截断
SELECT MICROSECONDS_DIFF(
    CAST('2025-01-02 03:04:05.123457788' AS TIMESTAMP_NS),
    CAST('2025-01-02 03:04:05.123456789' AS TIMESTAMP_NS)
);
+----------------------------------------------------------------------------------------------------+
| MICROSECONDS_DIFF(CAST('2025-01-02 03:04:05.123457788' AS TIMESTAMP_NS), CAST('2025-01-02 03:04:05.123456789' AS TIMESTAMP_NS)) |
+----------------------------------------------------------------------------------------------------+
|                                                                                                  0 |
+----------------------------------------------------------------------------------------------------+

---输入类型为 date ,时间部分会自动设置为 00:00:00.000000
SELECT MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01');
+---------------------------------------------------------------+
| MICROSECONDS_DIFF('2023-10-01 12:00:00.500000', '2023-10-01') |
+---------------------------------------------------------------+
|                                                   43200500000 |
+---------------------------------------------------------------+

---任意参数为 NULL,返回 NULL
SELECT MICROSECONDS_DIFF('2023-01-01 00:00:00', NULL), MICROSECONDS_DIFF(NULL, '2023-01-01 00:00:00');
+------------------------------------------------+------------------------------------------------+
| MICROSECONDS_DIFF('2023-01-01 00:00:00', NULL) | MICROSECONDS_DIFF(NULL, '2023-01-01 00:00:00') |
+------------------------------------------------+------------------------------------------------+
|                                           NULL |                                           NULL |
+------------------------------------------------+------------------------------------------------+

--- 时间完全相同,返回 0
 SELECT MICROSECONDS_DIFF('2025-08-11 15:30:00.123456', '2025-08-11 15:30:00.123456');
+-------------------------------------------------------------------------------+
| MICROSECONDS_DIFF('2025-08-11 15:30:00.123456', '2025-08-11 15:30:00.123456') |
+-------------------------------------------------------------------------------+
|                                                                             0 |
+-------------------------------------------------------------------------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。