timespan 数据类型

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

timespantime 数据类型是等效的。

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(nseconds) 时间间隔(秒)。 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