timespan 数据类型

适用于：✅Azure 数据资源管理器✅Azure Monitor✅Microsoft Sentinel

timespan 数据类型表示时间间隔。

timespan 和 time 数据类型是等效的。

`timespan` 文本

若要指定 timespan 文本，请使用以下语法选项之一：

Syntax	Description	Example	时间长度
n`d`	一个时间间隔，由一个或多个数字表示，后跟 `d` 表示天数。	`2d`	2 days
n`h`	一个时间间隔，由一个或多个数字表示，后跟 `h` 表示小时数。	`1.5h`	1.5 hours
n`m`	一个时间间隔，由一个或多个数字表示，后跟 `m` 表示分钟数。	`30m`	30 minutes
n`s`	一个时间间隔，由一个或多个数字表示，后跟 `s` 表示秒数。	`10s`	10 seconds
n`ms`	一个时间间隔，由一个或多个数字表示，后跟 `ms` 表示毫秒数。	`100ms`	100 milliseconds
n`microsecond`	一个时间间隔，由一个或多个数字表示，后跟 `microsecond`。	`10microsecond`	10 microseconds
n`tick`	一个时间间隔，由一个或多个数字表示，后跟 `tick` 表示纳秒数。	`1tick`	100 ns
`timespan(` n`seconds)`	时间间隔（秒）。	`timespan(15 seconds)`	15 seconds
`timespan(` n`)`	时间间隔（天）。	`timespan(2)`	2 days
`timespan(` 天`.`小时`:`分钟`:`秒`.`毫秒`)`	表示以天、小时、分钟和秒为单位的时间间隔。	`timespan(0.12:34:56.7)`	`0d+12h+34m+56.7s`
`timespan(null)`	表示 null 值。

Note

周不是受支持的时间长度。例如，不支持使用 nw 。

详细了解语法约定。

两个 timespan 类型的值可以相加、相减和相除。最后一个操作返回一个 real 类型的值，表示一个值可以是另一个值的小数倍。

下面的示例以多种方式计算一天中的秒数：

print
    result1 = 1d / 1s,
    result2 = time(1d) / time(1s),
    result3 = 24 * 60 * time(00:01:00) / time(1s)

此示例将一天中的秒数（由整数值表示）转换为时间跨度单位：

print 
    seconds = 86400
| extend t = seconds * 1s