Freigeben über


FIRSTDATE-Funktion

Gibt das erste Datum für die angegebene Datumsspalte im aktuellen Kontext zurück.

Syntax

FIRSTDATE(<dates>)

Parameter

Begriff

Definition

dates

Eine Spalte, die Datumsangaben enthält.

Rückgabewert

Eine Tabelle, die eine einzelne Spalte und einzelne Zeile mit einem Datumswert enthält.

Hinweise

HinweisHinweis

Unter Kontext in DAX-Formeln wird näher erläutert, wie sich der Kontext auf die Formelergebnisse auswirkt.

Das dates-Argument kann Folgendes darstellen:

  • Verweis auf eine Datums-/Uhrzeitspalte

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

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

HinweisHinweis

Einschränkungen für boolesche Ausdrücke werden im Thema CALCULATE-Funktion beschrieben.

Wenn der aktuelle Kontext einem einzelnen Datum entspricht, ist das von der FIRSTDATE-Funktion und der LASTDATE-Funktion zurückgegebene Datum identisch.

Technisch gesehen, ist der Rückgabewert eine Tabelle, die eine einzelne Spalte und einen einzelnen Wert enthält. Daher kann diese Funktion als Argument für jede Funktion verwendet werden, in deren Argumenten eine Tabelle erforderlich ist. Darüber hinaus kann der zurückgegebene Wert immer dann verwendet werden, wenn ein Datumswert erforderlich ist.

Diese DAX-Funktion wird im DirectQuery-Modus nicht unterstützt. Weitere Informationen zu Beschränkungen in DirectQuery-Modellen finden Sie unter https://go.microsoft.com/fwlink/?LinkId=219172.

Beispiel

Mit der folgenden Beispielformel wird ein Measure erstellt, das das erste Datum, zu dem ein Verkauf über den Internetvertriebskanal getätigt wurde, für den aktuellen Kontext abruft.

Zur Veranschaulichung erstellen Sie eine PivotTable und fügen dem Bereich Zeilenbezeichnungen der PivotTable das Feld "CalendarYear" hinzu. Fügen Sie dann dem Bereich Werte der PivotTable unter Verwendung der im Codeabschnitt definierten Formel ein Measure mit der Bezeichnung FirstSaleDate hinzu.

=FIRSTDATE('InternetSales_USD'[SaleDateKey])

Siehe auch

Verweis

LASTDATE-Funktion

FIRSTNONBLANK-Funktion

Andere Ressourcen

Datums- und Uhrzeitfunktionen (DAX)

Zeitintelligenzfunktionen (DAX)

Abrufen von Beispieldaten