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 後面接著指出 nanoseconds。 1tick 100 ns
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)

此範例會將一天中的秒數 (以整數值表示) 轉換為 timespan 單位:

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