Compartilhar via


startofyear()

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

Sintaxe

startofyear(data [, deslocamento ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
date datetime ✔️ A data para encontrar o início do ano.
deslocamento int O número de anos a serem compensados a partir da data de entrada. O padrão é 0.

Devoluções

Uma data/hora que representa o início do ano para o valor de data determinado, com o deslocamento, se especificado.

Exemplo

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

Saída

anoInício
2016-01-01 00:00:00.0000000
2017-01-01 00:00:00.0000000
2018-01-01 00:00:00.0000000