Condividi tramite


datetime_add()

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati Azure MonitorMicrosoft Sentinel

Calcola un nuovo valore datetime da un periodo specificato moltiplicato per un importo specificato, aggiunto o sottratto da un valore datetime specificato.

Sintassi

datetime_add(periodo,datetime,)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
periodo string ✔️ Intervallo di tempo in base al quale incrementare.
importo int ✔️ Numero di periodi da aggiungere o sottrarre da datetime.
datetime datetime ✔️ Data da incrementare in base al risultato del calcolo dell'importo x del periodo.

Valori possibili del periodo:

  • Anno
  • Trimestre
  • Mese
  • Settimana
  • Giorno
  • Ore
  • Minute
  • Secondo
  • Millisecond
  • Microsecond
  • Nanosecond

Valori restituiti

Un valore datetime dopo l'aggiunta di un determinato intervallo di data/ora.

Esempi

Periodo

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

Output

year quarter mese settimana Giorno ora minuto 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

Periodo

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

Output

year quarter mese settimana
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z