Partilhar via

datetime_add()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula uma nova data/hora de um período especificado multiplicada por uma quantidade especificada, adicionada ou subtraída de uma data/hora especificada.

Sintaxe

datetime_add( período,Montante,datetime)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
período string ✔️ O período de tempo pelo qual incrementar.
montante int ✔️ O número de períodos a serem adicionados ou subtraídos de datetime.
datetime datetime ✔️ A data a incrementar pelo resultado do período x cálculo do montante .

Valores possíveis de período:

  • Ano
  • Trimestre
  • Mês
  • Semana
  • Dia
  • Hora
  • Minuto
  • Segundo
  • Milissegundos
  • Microssegundo
  • Nanossegundos

Devoluções

Retorna um datetime após um determinado intervalo de tempo/data ter sido adicionado.

Exemplos

O exemplo a seguir mostra como adicionar um ponto a um valor datetime com a datetime_add função.

Executar a consulta

print  year = datetime_add('year',1,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',1,make_datetime(2017,1,1)),
month = datetime_add('month',1,make_datetime(2017,1,1)),
week = datetime_add('week',1,make_datetime(2017,1,1)),
day = datetime_add('day',1,make_datetime(2017,1,1)),
hour = datetime_add('hour',1,make_datetime(2017,1,1)),
minute = datetime_add('minute',1,make_datetime(2017,1,1)),
second = datetime_add('second',1,make_datetime(2017,1,1))

Realização

ano trimestre mês semana Dia hora minuto segundo
2018-01-01 00:00:00.0000000 2017-04-01 00:00:00.0000000 2017-02-01 00:00:00.0000000 2017-01-08 00:00:00.0000000 2017-01-02 00:00:00.0000000 2017-01-01 01:00:00.0000000 2017-01-01 00:01:00.0000000 2017-01-01 00:00:01.0000000

O exemplo a seguir demonstra como usar a datetime_add função para adicionar ou subtrair intervalos de tempo de uma data específica.

Executar a consulta

print  year = datetime_add('year',-5,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',12,make_datetime(2017,1,1)),
month = datetime_add('month',-15,make_datetime(2017,1,1)),
week = datetime_add('week',100,make_datetime(2017,1,1))

Realização

ano trimestre mês semana
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z
  • Last updated on