Freigeben über

bin_at()

  • Artikel

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Gibt den Wert zurück, der auf die nächste Containergröße abgerundet wird, die an einem festen Bezugspunkt ausgerichtet ist.

Im Gegensatz zur Bin() -Funktion, bei der der Ausrichtungspunkt vordefiniert ist, können Sie bin_at() einen festen Punkt für die Ausrichtung definieren. Ergebnisse können vor oder nach dem festen Punkt ausgerichtet werden.

Syntax

bin_at(wert,bin_size fixed_point,)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
value int, long, real, timespan oder datetime ✔️ Hierbei handelt es sich um den zu rundenden Wert.
bin_size int, long, real oder timespan ✔️ Die Größe der einzelnen Fächer.
fixed_point int, long, real, timespan oder datetime ✔️ Eine Konstante desselben Typs wie der Wert, der als fester Bezugspunkt verwendet wird.

Hinweis

Wenn der Wert ein timespan oder datetimeist, muss die bin_size ein timespan.

Gibt zurück

Das nächste Vielfache von bin_size unter dem angegebenen Wert , der an den angegebenen fixed_point ausgerichtet ist.

Beispiele

Im folgenden Beispiel wird der Wert auf die nächste bin_size abgerundet, die an der fixed_point ausgerichtet ist.

print bin_at(6.5, 2.5, 7)

Output

print_0
4.5

Im folgenden Beispiel wird das Zeitintervall in täglichen Bins an einem festen 12-Stunden-Punkt ausgerichtet. Der Rückgabewert ist -12, da ein täglicher Bin, der auf 12 Stunden ausgerichtet ist, auf 12 Aufrunden auf 12 am vorherigen Tag ausgerichtet ist.

print bin_at(time(1h), 1d, 12h)

Output

print_0
-12:00:00

Im folgenden Beispiel werden die täglichen Bins am Mittag ausgerichtet.

print bin_at(datetime(2017-05-15 10:20:00.0), 1d, datetime(1970-01-01 12:00:00.0))

Output

print_0
2017-05-14T12:00:00Z

Im folgenden Beispiel werden Die Bins wöchentlich und am Anfang des Sonntags, dem 6. Juni 2017, ausgerichtet. Das Beispiel gibt einen Korb zurück, der an Sonntagen ausgerichtet ist.

print bin_at(datetime(2017-05-17 10:20:00.0), 7d, datetime(2017-06-04 00:00:00.0))

Output

print_0
2017-05-14T00:00:00Z

Im folgenden Beispiel werden die Gesamtzahl der Ereignisse in täglichen Bins gruppiert, die am fixed_point Datum und Uhrzeit ausgerichtet sind. Der fixed_point Wert ist in einem der zurückgegebenen Bins enthalten.

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

Output

Datum TotalEvents
2018-02-23T15:14:00Z 8
2018-02-24T15:14:00Z 7
2018-02-26T15:14:00Z 5

Zugehöriger Inhalt