datetime_diff()

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

Calcula o número de períodos especificados entre dois valores de data e hora .

Sintaxe

datetime_diff( período,datetime1,datetime2)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Valores possíveis de período

Esses valores não diferenciam maiúsculas de minúsculas:

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

Devoluções

Retorna um inteiro que representa a quantidade de períodos no resultado da subtração (datetime1 - datetime2).

Exemplos

O exemplo a seguir mostra como calcular o período entre dois valores datetime com a datetime_diff função.

print
year = datetime_diff('year',datetime(2017-01-01),datetime(2000-12-31)),
quarter = datetime_diff('quarter',datetime(2017-07-01),datetime(2017-03-30)),
month = datetime_diff('month',datetime(2017-01-01),datetime(2015-12-30)),
week = datetime_diff('week',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
day = datetime_diff('day',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
hour = datetime_diff('hour',datetime(2017-10-31 01:00),datetime(2017-10-30 23:59)),
minute = datetime_diff('minute',datetime(2017-10-30 23:05:01),datetime(2017-10-30 23:00:59)),
second = datetime_diff('second',datetime(2017-10-30 23:00:10.100),datetime(2017-10-30 23:00:00.900)),
millisecond = datetime_diff('millisecond',datetime(2017-10-30 23:00:00.200100),datetime(2017-10-30 23:00:00.100900)),
microsecond = datetime_diff('microsecond',datetime(2017-10-30 23:00:00.1009001),datetime(2017-10-30 23:00:00.1008009)),
nanosecond = datetime_diff('nanosecond',datetime(2017-10-30 23:00:00.0000000),datetime(2017-10-30 23:00:00.0000007))

Saída