DATEADD

Gilt für:Berechnete SpalteBerechnete TabelleMeasurevisuelle Berechnung

Anmerkung

Diese Funktion wird für die Verwendung in visuellen Berechnungen abgeraten, da sie wahrscheinlich sinnlose Ergebnisse zurückgibt.

Gibt eine Tabelle zurück, die eine Spalte mit Datumsangaben enthält, die entweder vorwärts oder rückwärts um die angegebene Anzahl von Intervallen aus den Datumsangaben im aktuellen Kontext verschoben wird.

Syntax

DATEADD(<dates>,<number_of_intervals>,<interval>)

Parameter

Ausdruck	Definition
dates	Eine Spalte, die Datumsangaben enthält.
number_of_intervals	Eine ganze Zahl, die die Anzahl der Intervalle angibt, die zu den Datumsangaben addiert oder subtrahiert werden sollen.
interval	Das Intervall, nach dem die Datumsangaben verschoben werden sollen. Der Wert für das Intervall kann eine der folgenden sein: year, quarter, month, day

Rückgabewert

Eine Tabelle, die eine einzelne Spalte mit Datumswerten enthält.

Bemerkungen

Das argument dates kann eine der folgenden sein:

• Ein Verweis auf eine Datums-/Uhrzeitspalte,

• Ein Tabellenausdruck, der eine einzelne Spalte mit Datums-/Uhrzeitwerten zurückgibt,

• Ein boolescher Ausdruck, der eine einspaltige Tabelle mit Datums-/Uhrzeitwerten definiert.

  Anmerkung

  Einschränkungen für boolesche Ausdrücke werden im Thema CALCULATE Funktionbeschrieben.

• Wenn die für number_of_intervals angegebene Zahl positiv ist, werden die Datumsangaben in dates nach vorne verschoben; Wenn die Zahl negativ ist, werden die Datumsangaben in dates zurück in die Zeit verschoben.

• Der interval-Parameter ist eine Enumeration, keine Gruppe von Zeichenfolgen; Daher sollten werte nicht in Anführungszeichen eingeschlossen werden. Außerdem sollten die Werte: year, quarter, month, day vollständig geschrieben werden, wenn sie verwendet 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.

• Diese Funktion wird für die Verwendung im DirectQuery-Modus nicht unterstützt, wenn sie in berechneten Spalten oder Sicherheitsregeln auf Zeilenebene (RLS) verwendet wird.

Beispiel: Verschieben eines Satzes von Datumsangaben

Mit der folgenden Formel werden Datumsangaben berechnet, die ein Jahr vor den Datumsangaben im aktuellen Kontext liegen.

= DATEADD(DateTime[DateKey],-1,year)

Verwandte Inhalte

ZeitintelligenzfunktionenDatums- und Uhrzeitfunktionen