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

timespan 数据类型

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

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

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

timespan 文本

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

语法	说明	示例	时间长度
nd	一个时间间隔，由一个或多个数字表示，后跟 d 表示天数。	2d	2 天
nh	一个时间间隔，由一个或多个数字表示，后跟 h 表示小时数。	1.5h	1.5 小时
nm	一个时间间隔，由一个或多个数字表示，后跟 m 表示分钟数。	30m	30 分钟
ns	一个时间间隔，由一个或多个数字表示，后跟 s 表示秒数。	10s	10 秒
nms	一个时间间隔，由一个或多个数字表示，后跟 ms 表示毫秒数。	100ms	100 毫秒
nmicrosecond	一个时间间隔，由一个或多个数字表示，后跟 microsecond。	10microsecond	10 微秒
ntick	一个时间间隔，由一个或多个数字表示，后跟 tick 表示纳秒数。	1tick	100 纳秒
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 运算符

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

相关内容

• totimespan 函数
• make-timespan 函数