Freigeben über


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 für die Datumsspalteneingabe das erste Datum des Jahres im aktuellen Kontext für die angegebene Spalte von Datumsangaben zurück.
Gibt für die Kalendereingabe eine Tabelle für das erste Jahr im aktuellen Kontext zurück. Die Tabelle enthält alle primären markierten Spalten und alle zeitbezogenen Spalten.

Syntax

STARTOFYEAR(<dates> or <calendar>)

Parameter

Begriff Definition
dates or calendar Eine Spalte, die Datumsangaben oder einen Kalenderverweis enthält.
YearEndDate (Optional) Ein Jahresenddatumswert. Gilt nur für Datumsspalteneingaben.

Rückgabewert

Bei der Datumsspalteneingabe enthält eine Tabelle, die eine einzelne Spalte und eine Zeile mit einem Datumswert enthält.
Für kalendereingaben eine Tabelle für das erste Datum des Jahres im aktuellen Kontext. Die Tabelle enthält alle primären markierten Spalten und alle zeitbezogenen Spalten.

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.
  • Einschränkungen für boolesche Ausdrücke werden im Thema CALCULATEbeschrieben.

  • Der year_end_date Parameter darf nicht angegeben werden, wenn ein Kalender verwendet wird.

  • 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

Mit der folgenden Beispielformel wird ein Measure erstellt, das den Anfang des Jahres für den aktuellen Kontext zurückgibt.

= STARTOFYEAR(DateTime[DateKey])

Beispiel für kalenderbasierte Zeitintelligenz

Die folgende Beispielformel erstellt eine Tabelle, die markierte Spalten zurückgibt, die dem Anfang des Jahres für den Geschäftskalender entsprechen.

= STARTOFYEAR(FiscalCalendar)

Datums- und UhrzeitfunktionenZeitintelligenzfunktionenSTARTOFQUARTERSTARTOFMONTHSTARTOFWEEK