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(period,amount,datetime)
Obtenga más información sobre las convenciones de sintaxis.
Parámetros
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| period | 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:
- Year
- Quarter (Trimestre)
- Mes
- Semana
- Día
- Hora
- Minuto
- Second
- Millisecond
- Microsecond
- Nanosecond
Devoluciones
Fecha y hora después de agregar un intervalo de fecha y hora determinado.
Ejemplos
Período
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
| year | quarter | month | week | day | hora | minute | second |
|---|---|---|---|---|---|---|---|
| 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 |
Amount
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
| year | quarter | month | week |
|---|---|---|---|
| 2012-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |