bin_at()

値を固定サイズのビンに切り捨て、ビンの開始点を制御します。

構文

bin_at(値,, bin_sizefixed_point)

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

パラメーター

名前	型	必須	説明
value	int、long、real、timespan、または datetime	✔️	丸める値。
bin_size	int、long、real、または timespan	✔️	各ビンのサイズ。
fixed_point	int、long、real、timespan、または datetime	✔️	値の 1 つの 値 を示す値と同じ 型の定数。これは、 の 固定ポイント です bin_at(fixed_point, bin_size, fixed_point) == fixed_point。

注意

value が timespan または datetime の場合、bin_sizeは timespan である必要があります。

戻り値

値の最も近い倍数bin_size、fixed_pointがそれ自体に変換されるようにシフトされます。

例

正規表現	結果	コメント
bin_at(6.5, 2.5, 7)	4.5
bin_at(time(1h), 1d, 12h)	-12h
bin_at(datetime(2017-05-15 10:20:00.0), 1d, datetime(1970-01-01 12:00:00.0))	datetime(2017-05-14 12:00:00.0)	すべてのビンが正午になります
bin_at(datetime(2017-05-17 10:20:00.0), 7d, datetime(2017-06-04 00:00:00.0))	datetime(2017-05-14 00:00:00.0)	すべてのビンが日曜日になります

次の例では、"fixed point" 引数がビンの 1 つとして返され、それに合わせて他のビンが bin_size に基づいて配置されています。 また、各 datetime ビンは、そのビンの開始時刻を表します。

クエリを実行する

datatable(Date:datetime, Num:int)[
datetime(2018-02-24T15:14),3,
datetime(2018-02-23T16:14),4,
datetime(2018-02-26T15:14),5]
| summarize sum(Num) by bin_at(Date, 1d, datetime(2018-02-24 15:14:00.0000000)) 

出力

Date	sum_Num
2018-02-23 15:14:00.0000000	4
2018-02-24 15:14:00.0000000	3
2018-02-26 15:14:00.0000000	5

関連コンテンツ

• bin()