Share via


startofyear()

Devolve o início do ano que contém a data, movida por um desvio, se for fornecido.

Syntax

startofyear(date [,offset ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
data datetime ✔️ A data para a qual pode encontrar o início do ano.
desvio int O número de anos a desfasar da data de entrada. A predefinição é 0.

Devoluções

Um datetime que representa o início do ano para o valor de data especificado, com o desvio, se especificado.

Exemplo

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

Saída

início do ano
2016-01-01 00:00:00.0000000
2017-01-01 00:00:00.0000000
2018-01-01 00:00:00.0000000