DATEADD

  • Artikel

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, monthund day 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)

Zugehöriger Inhalt

Zeitintelligenzfunktionen
Datums- und Uhrzeitfunktionen