bin_at()bin_at()

ビンの開始点を制御して、値を固定サイズの "ビン" に切り捨てます。Rounds values down to a fixed-size "bin", with control over the bin's starting point. (「」も参照してください bin function )。(See also bin function.)

構文Syntax

bin_at``(ビン , サイズ , fixedpoint)bin_at (Expression, BinSize, FixedPoint)

引数Arguments

  • : 数値型のスカラー式 (およびを含む datetime timespan )。丸め対象の値を示します。Expression: A scalar expression of a numeric type (including datetime and timespan) indicating the value to round.
  • Binsize: timespan datetime timespan 各ビンのサイズを示す数値型または (または の場合) のスカラー定数。BinSize: A scalar constant of a numeric type or timespan (for a datetime or timespan Expression) indicating the size of each bin.
  • Fixedpoint: "固定ポイント" (つまり、値Expression ) であるexpressionの1つの値を示す式と同じ型のスカラー定数。 fixed_point bin_at(fixed_point, bin_size, fixed_point) == fixed_pointFixedPoint: A scalar constant of the same type as Expression indicating one value of Expression which is a "fixed point" (that is, a value fixed_point for which bin_at(fixed_point, bin_size, fixed_point) == fixed_point.)

戻り値Returns

下にあるビンサイズの最も近い倍数をシフトして、 fixedpointがそれ自体に変換されるようにしますThe nearest multiple of BinSize below Expression, shifted so that FixedPoint will be translated into itself.

Examples

正規表現Expression 結果Result 説明Comments
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) すべてのビンが正午になりますAll bins will be at noon
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) すべてのビンが日曜日に表示されますAll bins will be on Sundays

次の例では、 "fixed point" arg がビンの1つとして返され、他のビンがに基づいてそのビンにアラインされていることに注意して bin_size ください。In the following example, notice that the "fixed point" arg is returned as one of the bins and the other bins are aligned to it based on the bin_size. また、各 datetime bin は、その bin の開始時刻を表しています。Also note that each datetime bin represents the starting time of that bin:


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)) 
DateDate sum_Numsum_Num
2018-02-23 15:14: 00.00000002018-02-23 15:14:00.0000000 44
2018-02-24 15:14: 00.00000002018-02-24 15:14:00.0000000 33
2018-02-26 15:14: 00.00000002018-02-26 15:14:00.0000000 55