Compartir a través de

datetime_add()

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcula una fecha y hora nueva a partir de un período especificado multiplicado por una cantidad especificada, agregada a o restada de una fecha y hora especificada.

Sintaxis

datetime_add( periodo,importe,datetime)

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

Parámetros

Nombre Tipo Obligatorio Descripción
periodo string ✔️ Período de tiempo por el que se va a incrementar.
importe int ✔️ Número de períodos que se van a agregar o restar de datetime.
datetime datetime ✔️ Fecha que se va a incrementar por el resultado del cálculo de la cantidad x del período.

Valores posibles de punto:

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

Devoluciones

Devuelve una fecha y hora después de agregar un intervalo de fecha y hora determinado.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar un punto a un valor datetime con la datetime_add función .

Ejecución de la 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))

Salida

año cuarto mes semana día 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

En el ejemplo siguiente se muestra cómo usar la datetime_add función para agregar o restar intervalos de tiempo de una fecha específica.

Ejecución de la 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))

Salida

año cuarto mes semana
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z
  • Last updated on