Delen via


datum_tijd_toevoegen()

Van toepassing op: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Berekent een nieuwe datum/tijd van een opgegeven periode vermenigvuldigd met een opgegeven bedrag, toegevoegd aan of afgetrokken van een opgegeven datum/tijd.

Syntaxis

datetime_add( periode,aantal,datum/tijd)

Meer informatie over syntaxisconventies.

Parameterwaarden

Naam Typologie Verplicht Beschrijving
periode string ✔️ De tijdsduur waarop moet worden verhoogd.
aantal int ✔️ Het aantal perioden dat moet worden toegevoegd aan of afgetrokken van datum/tijd.
datum en tijd datetime ✔️ De datum die moet worden verhoogd met het resultaat van de berekening van het bedrag van de periode x.

Mogelijke waarden van punt:

  • Jaar
  • Kwartaal
  • Maand
  • Week
  • Dag
  • Uur
  • Minuut
  • Tweede
  • Milliseconde
  • Microseconde
  • Nanoseconde

Retouren

Hiermee wordt een datum/tijd geretourneerd nadat een bepaald tijd-/datuminterval is toegevoegd.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een punt toevoegt aan een datum/tijd-waarde met de datetime_add functie.

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

Uitvoer

jaar wijk maand week dagen uur minuut tweede
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

In het volgende voorbeeld ziet u hoe u de datetime_add functie gebruikt om tijdsintervallen van een specifieke datum toe te voegen of af te trekken.

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

Uitvoer

jaar wijk maand week
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z