Share via


Timespan データ型

データ型は timespan 時間間隔を表します。

timespantime のデータ型は同等です。

timespan リテラル

リテラルを timespan 指定するには、次のいずれかの構文オプションを使用します。

構文 説明 時間の長さ
nd 1 つ以上の数字で表され、その後に日数が d 続く時間間隔。 2d 2 日
nh 1 つ以上の数字で表され、その後に h 時間が続く時間間隔。 1.5h 1.5 時間
nm 1 つ以上の数字で表され、その後に分単位で続く m 時間間隔。 30m 30 分
ns 1 つ以上の数字で表され、その後に秒が続く s 時間間隔。 10s 10 秒
nms 1 つ以上の数字で表され、その後にミリ秒単位で続く ms 時間間隔。 100ms 100 ミリ秒
nmicrosecond 1 つ以上の数字の後に が続く microsecondによって表される時間間隔。 10microsecond 10 マイクロ秒
ntick ナノ秒を示すために、1 つ以上の数字で tick 表される時間間隔。 1tick 100 ns
timespan(timespan(seconds) 秒単位の時間間隔。 timespan(15 seconds) 15 秒
timespan(timespan() 日数単位の時間間隔。 timespan(2) 2 日
timespan(.時間::.ミリ秒) 経過した日、時間、分、秒の時間間隔。 timespan(0.12:34:56.7) 0d+12h+34m+56.7s
timespan(null) null 値を表します。

構文規則について詳しく知る。

timespan 演算子

timespan の2つの値を加算、減算、および除算できます。 最新の操作は、1 つの値が他方の値に適合する回数を表す型 real の値を返します。

次の例では、いくつかの方法で 1 日に含まれる秒数を計算します。

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

この例では、1日 (整数値で表される) の秒数を timespan 単位に変換します。

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