Freigeben über


FIRSTDATE

Gilt für:Berechnete SpalteBerechnete TabelleMeasureVisuelle Berechnung

Hinweis

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

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

Syntax

FIRSTDATE(<dates>)  

Parameter

Begriff Definition
Datumsangaben Eine Spalte mit Datumsangaben.

Rückgabewert

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

Bemerkungen

  • Das dates-Argument kann folgende Werte aufweisen:

    • Ein Verweis auf eine Datums-/Uhrzeitspalte
    • Einen Tabellenausdruck, der eine einzelne Spalte mit Datums-/Uhrzeitwerten zurückgibt
    • Ein boolescher Ausdruck, der eine Tabelle mit einer einzelnen Spalte mit Datums-/Uhrzeitwerten definiert
  • Einschränkungen für boolesche Ausdrücke werden im Thema CALCULATE-Funktion beschrieben.

  • Wenn der aktuelle Kontext ein einzelnes Datum ist, ist das von den Funktionen FIRSTDATE und LASTDATE zurückgegebene Datum gleich.

  • Beim Rückgabewert handelt es sich um eine Tabelle, die eine einzelne Spalte und einen einzelnen Wert enthält. Daher kann diese Funktion als Argument für jede Funktion verwendet werden, die in ihren Argumenten eine Tabelle erfordert. Außerdem kann der zurückgegebene Wert immer dann verwendet werden, wenn ein Datumswert erforderlich ist.

  • 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

Mit der folgenden Beispielformel wird ein Measure erstellt, das das erste Datum für den aktuellen Kontext erhält, wenn ein Umsatz im Internet-Vertriebskanal erzielt wurde.

= FIRSTDATE('InternetSales_USD'[SaleDateKey])  

Datums- und Uhrzeitfunktionen
Zeitintelligenzfunktionen
LASTDATE-Funktion
FIRSTNONBLANK-Funktion