你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

timespan 数据类型

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

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

`timespan` 文本

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

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

详细了解语法约定。

两个 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