DAX DATEADD Funktion
Die DAX DATEADD Funktion gehört zu den DAX Datums- und Uhrzeitfunktionen und gibt eine Tabelle zurück, die eine Spalte mit Datumswerten enthält, die um die angegebene Anzahl von Intervallen im aktuellen Kontext entweder vorwärts oder rückwärts in der Zeit verschoben wurde.Das Ergebnis der DATEADD Funktion ist eine Tabelle, die eine einzelne Spalte mit Datumswerten enthält.
Das Beispiel zur DAX DATEADD Funktion zeigt den Einsatz und die Möglichkeiten dieser DAX Funktion.
DAX DATEADD Funktion Syntax
Die DAX DATEADD Funktion kann folgendermaßen verwendet werden:
DATEADD(<dates>,<number_of_intervals>,<interval>)
Folgende Parameter müssen in der Funktion eingesetzt werden:
- dates: Eine Spalte mit Datumsangaben.
- number_of_intervals: Eine ganze Zahl, welche die Anzahl der Intervalle angibt, die zu dem Datum addiert oder von ihnen subtrahiert werden sollen.
- interval: Das Intervall, um dass das Datum verschoben werden soll. Der Wert für das Intervall kann eines der Folgenden sein: Jahr, Quartal, Monat, Tag.
Das Datumsargument (dates) kann eines der Folgenden sein:
- Eine Referenz auf ein(e) Datum/Uhrzeit-Spalte,
- Ein Tabellenausdruck, der eine einzelne Spalte mit Datums-/Zeitwerten zurückgibt,
- Ein boolescher Ausdruck, der eine einspaltige Tabelle von Datums-/Zeitwerten definiert.
Alle Einschränkungen bei booleschen Ausdrücken können in der DAX CALCULATE-Funktion nachgelesen werden.
Wenn der Eingabeparameter (number_of_intervals) für die angegebene Zahl positiv ist, werden die Datumswerte in der Zeit vorwärts verschoben. Wenn die Zahl negativ ist, werden die Datumswerte in der Zeit rückwärts verschoben.
Der Intervallparameter (interval) ist eine Aufzählung, nicht eine Menge von Zeichenketten. Daher sollten die Werte nicht in Anführungszeichen eingeschlossen werden. Auch die Werte: Jahr, Quartal, Monat und Tag sollten bei der Verwendung vollständig ausgeschrieben werden.
Die Ergebnistabelle enthält nur Datumswerte, die auch in der Spalte vorhanden sind.
Wenn die Daten im aktuellen Kontext kein zusammenhängendes Intervall bilden, gibt die DATEADD-Funktion einen Fehler zurück.
DAX DATEADD Funktion Beispiel
Das folgende DAX DATEADD Beispiel berechnet ein Datum auf Basis des aktuellen Datums, welches genau ein Jahr zurückliegt:
=DATEADD(DateTime[Datum],-1,year)