startofyear()

  • Artykuł

Zwraca początek roku zawierającego datę przesuniętą przez przesunięcie, jeśli zostanie podane.

Składnia

startofyear(date [,przesunięcie ])

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
Data datetime ✔️ Data znalezienia początku roku.
Przesunięcie int Liczba lat do przesunięcia z daty wejściowej. Wartość domyślna to 0.

Zwraca

Data/godzina reprezentująca początek roku dla danej wartości daty z przesunięciem, jeśli zostanie określona.

Przykład

Uruchamianie zapytania

range offset from -1 to 1 step 1
| project yearStart = startofyear(datetime(2017-01-01 10:10:17), offset)

Dane wyjściowe

yearStart
2016-01-01 00:00:00.0000000
2017-01-01 00:00:00.0000000
2018-01-01 00:00:00.0000000