DATEADD
Gilt für:berechnete Spaltenberechnete TabellenMeasuresvisuelle Berechnungen
Hinweis
Von der Verwendung dieser Funktion in visuellen Berechnungen wird abgeraten, da sie wahrscheinlich bedeutungslose Ergebnisse zurückgibt.
Gibt eine Tabelle zurück, die eine Spalte mit Daten enthält, die um die angegebene Anzahl von Intervallen von den Datumsangaben im aktuellen Kontext entweder vorwärts oder rückwärts in der Zeit verschoben wurde.
Syntax
DATEADD(<dates>,<number_of_intervals>,<interval>)
Parameter
Begriff | Definition |
---|---|
Datumsangaben | Eine Spalte mit Datumsangaben. |
number_of_intervals | Eine ganze Zahl, die die Anzahl der Intervalle angibt, die zu den Datumsangaben addiert oder davon subtrahiert werden sollen |
interval | Das Intervall, in dem die Datumsangaben verschoben werden. Der Wert für das Intervall kann einer der folgenden sein: year , quarter , month , day |
Rückgabewert
Eine Tabelle, die eine einzelne Spalte mit Datumswerten enthält
Bemerkungen
Das dates-Argument kann folgende Werte aufweisen:
Einen Verweis auf eine Datum/Uhrzeit-Spalte
Einen Tabellenausdruck, der eine einzelne Spalte mit Datum/Uhrzeit-Werten zurückgibt
Ein boolescher Ausdruck, der eine Tabelle mit einer einzelnen Spalte mit Datums-/Uhrzeitwerten definiert
Hinweis
Einschränkungen für boolesche Ausdrücke werden im Thema CALCULATE-Funktion beschrieben.
Wenn die für number_of_intervals angegebene Zahl positiv ist, werden die Datumsangaben in dates zeitlich vorwärts verschoben. Wenn die Zahl negativ ist, werden die Datumsangaben in dates zeitlich rückwärts verschoben.
Der Parameter interval ist eine Enumeration, keine Gruppe von Zeichenfolgen. Daher dürfen Werte nicht in Anführungszeichen gesetzt werden. Außerdem müssen die Werte
year
,quarter
,month
undday
bei ihrer Verwendung ausgeschrieben werden.Die Ergebnistabelle enthält nur Datumsangaben, die in der Spalte dates vorhanden sind.
Wenn die Datumsangaben im aktuellen Kontext kein zusammenhängendes Intervall bilden, gibt die Funktion einen Fehler zurück.
Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.
Beispiel: Verschieben einer Gruppe von Datumsangaben
Die folgende Formel berechnet Datumsangaben, die ein Jahr vor den Datumsangaben im aktuellen Kontext liegen.
= DATEADD(DateTime[DateKey],-1,year)