STARTOFYEAR

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 des Jahres im aktuellen Kontext für die angegebene Datumsspalte zurück

Syntax

STARTOFYEAR(<dates>)  

Parameter

Begriff Definition
Datumsangaben Eine Spalte mit Datumsangaben.
YearEndDate (Optional) Der Wert für das Enddatum eines Jahrs.

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 beschrieben.

  • 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 den Anfang des Jahrs für den aktuellen Kontext zurückgibt.

= STARTOFYEAR(DateTime[DateKey])  

Datums- und Uhrzeitfunktionen
Zeitintelligenzfunktionen
STARTOFQUARTER
STARTOFMONTH