GitHub在 GitHub中添加内容: 在线编辑

datetime_diff ()

计算两个 datetime 值之间的指定周期数。

语法

datetime_diff(句点,datetime1,datetime2)

参数

名称 类型 必需 描述
周期 字符串 ✓ 用于计算返回值的时间的度量。 请参阅 可能的值 (可能的 values)。
datetime1 日期时间 ✓ 减法方程的左手边。
datetime2 日期时间 ✓ 减法方程的右侧。

period 的可能值

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

退货

表示减法结果 (datetime1 - datetime2) 中的 句点 数量的整数。

示例

```kusto
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))


<p></p>

### Results

|year|quarter|month|week|day|hour|minute|second|millisecond|microsecond|nanosecond|
|----|-------|-----|----|---|----|------|------|-----------|-----------|----------|
|17  |2      |13   |5   |29 |2   |5     |10    |100        |100        |-700      |