Compartir a través de


diferencia_de_fecha_y_hora()

Se aplica a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Calcula el número de períodos especificados entre dos valores datetime .

Sintaxis

datetime_diff( periodo,datetime1,datetime2)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Tipo Obligatorio Descripción
periodo string ✔️ Medición del tiempo utilizado para calcular el valor devuelto. Vea los valores posibles.
datetime1 datetime ✔️ Lado izquierdo de la ecuación de resta.
datetime2 datetime ✔️ Lado derecho de la ecuación de resta.

Valores posibles de período

Estos valores no distinguen mayúsculas de minúsculas:

  • Año
  • Quarter (Trimestre)
  • Mes
  • Semana
  • Día
  • Hora
  • Minuto
  • Segundo
  • Milisegundo
  • Microsegundo
  • Nanosegundo

Devoluciones

Devuelve un entero que representa la cantidad de períodos en el resultado de la resta (datetime1 - datetime2).

Ejemplos

En el ejemplo siguiente se muestra cómo calcular el período entre dos valores datetime con la datetime_diff función .

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))

Salida

año cuarto mes semana día hora minuto segundo milisegundo microsegundo nanosegundo
17 2 13 5 29 2 5 10 100 100 -700