Freigeben über


datetime_add()

Gilt für: ✅Microsoft Fabric

Berechnet eine neue Datumszeit aus einem angegebenen Zeitraum, multipliziert mit einem angegebenen Betrag, hinzugefügt oder von einer angegebenen Datetime subtrahiert.

Syntax

datetime_add( Zeitraum datumstime,,)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich Beschreibung
Periode string ✔️ Die Zeitdauer, um die erhöht werden soll.
Menge int ✔️ Die Anzahl der Perioden , die von datetime addiert oder subtrahiert werden sollen.
datetime datetime ✔️ Das Datum, das durch das Ergebnis der Berechnung des Zeitraums x erhöht wird.

Mögliche Werte des Zeitraums:

  • Jahr
  • Quartal
  • Monat
  • Woche
  • Tag
  • Stunde
  • Minute
  • Sekunde
  • Millisekunde
  • Mikrosekunde
  • Nanosekunde

Gibt zurück

Gibt ein Datumstime zurück, nachdem ein bestimmtes Zeit-/Datumsintervall hinzugefügt wurde.

Beispiele

Das folgende Beispiel zeigt, wie Sie einem Datetime-Wert mit der datetime_add Funktion einen Punkt hinzufügen.

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

Ausgabe

Jahr Viertel Monat Woche Tag Stunde Minute Sekunde
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

Im folgenden Beispiel wird veranschaulicht, wie die datetime_add Funktion verwendet wird, um Zeitintervalle von einem bestimmten Datum hinzuzufügen oder zu subtrahieren.

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

Ausgabe

Jahr Viertel Monat Woche
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z