Timespan データ型

適用対象: ✅Microsoft Fabric✅Azure データエクスプローラー✅Azure Monitor✅Microsoft Sentinel

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

timespanとtimeのデータ型は同等です。

`timespan` リテラル

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

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

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

型 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