日期时间差()

适用于:✅Azure 数据资源管理器Azure MonitorMicrosoft Sentinel

计算两个日期/时间值之间指定的周期数。

语法

datetime_diff( 时期,datetime1,datetime2)

详细了解语法约定

参数

客户 类型​​ 必需 描述
时期 string ✔️ 用于计算返回值的时间度量。 请参阅可能的值
datetime1 datetime ✔️ 减法公式的左侧。
datetime2 datetime ✔️ 减法公式的右侧。

period 的可能值

这两个值都不区分大小写。

  • 年份
  • 季度
  • 月份
  • 日期
  • 小时
  • 分钟
  • 第二个
  • 毫秒
  • 微秒
  • 纳秒

返回

返回一个整数,表示减法(datetime1 - )结果中的句点量。

例子

以下示例演示如何使用函数计算两datetime_diff值之间的时间段。

print
year = datetime_diff('year',datetime(2017-01-01),datetime(2000-12-31)),
quarter = datetime_diff('quarter',datetime(2017-07-01),datetime(2017-03-30)),
month = datetime_diff('month',datetime(2017-01-01),datetime(2015-12-30)),
week = datetime_diff('week',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
day = datetime_diff('day',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
hour = datetime_diff('hour',datetime(2017-10-31 01:00),datetime(2017-10-30 23:59)),
minute = datetime_diff('minute',datetime(2017-10-30 23:05:01),datetime(2017-10-30 23:00:59)),
second = datetime_diff('second',datetime(2017-10-30 23:00:10.100),datetime(2017-10-30 23:00:00.900)),
millisecond = datetime_diff('millisecond',datetime(2017-10-30 23:00:00.200100),datetime(2017-10-30 23:00:00.100900)),
microsecond = datetime_diff('microsecond',datetime(2017-10-30 23:00:00.1009001),datetime(2017-10-30 23:00:00.1008009)),
nanosecond = datetime_diff('nanosecond',datetime(2017-10-30 23:00:00.0000000),datetime(2017-10-30 23:00:00.0000007))

输出

季度 月份 小时 分钟 第 2 个 毫秒 微秒 纳秒
十七 2 13 5 二十九 2 5 10 100 100 -700