Udostępnij za pośrednictwem

bin_at()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Zwraca wartość zaokrąglona w dół do najbliższego rozmiaru pojemnika, który jest wyrównany do stałego punktu odniesienia.

W przeciwieństwie do funkcji bin(), gdzie punkt wyrównania jest wstępnie zdefiniowany, bin_at() umożliwia zdefiniowanie stałego punktu wyrównania. Wyniki mogą być wyrównane przed lub po stałym punkcie.

Składnia

bin_at(bin_size fixed_point,wartości,)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania Popis
wartość int, , long, real, timespanlub datetime ✔️ Wartość do zaokrąglenie.
bin_size int, long, lub realtimespan ✔️ Rozmiar każdego pojemnika.
fixed_point int, , long, real, timespanlub datetime ✔️ Stała tego samego typu co wartość, która jest używana jako stały punkt odniesienia.

Uwaga

Jeśli wartość to timespan lub datetime, bin_size musi być wartością timespan.

Zwraca

Najbliższa wielokrotność bin_size poniżej podanej wartości, która jest zgodna z określoną fixed_point.

Przykłady

W poniższym przykładzie wartość jest zaokrąglona w dół do najbliższej bin_size , która jest wyrównana do fixed_point.

print bin_at(6.5, 2.5, 7)

Wyjście

print_0
4.5

W poniższym przykładzie przedział czasu jest umieszczany w pojemnikach dziennych wyrównywany do 12-godzinnego punktu stałego. Wartość zwracana wynosi -12, ponieważ pojemnik dzienny jest wyrównany do 12 godzin w dół do 12 w poprzednim dniu.

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

Wyjście

print_0
-12:00:00

W poniższym przykładzie pojemniki dzienne są wyrównane do południa.

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

Wyjście

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

W poniższym przykładzie pojemniki są cotygodniowe i są wyrównane do początku niedzieli 6 czerwca 2017 r. Przykład zwraca pojemnik wyrównany do niedziel.

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

Wyjście

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

W poniższym przykładzie łączna liczba zdarzeń jest pogrupowana w dzienne pojemniki wyrównane do fixed_point daty i godziny. Wartość fixed_point jest uwzględniona w jednym z zwróconych pojemników.

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))

Wyjście

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

Powiązana zawartość