startofyear()

  • Artigo

Retorna o início do ano contendo a data, alterada por um deslocamento, se fornecido.

Syntax

startofyear(date [,offset ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
date datetime ✔️ A data para a qual encontrar o início do ano.
offset int O número de anos a serem deslocados da data de entrada. O padrão é 0.

Retornos

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

Exemplo

Executar a consulta

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

Saída

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