TOTALYTD

Wertet den Wert für „Year-to-date“ (seit Jahresbeginn bis heute) des Ausdrucks im aktuellen Kontext aus.

Syntax

TOTALYTD(<expression>,<dates>[,<filter>][,<year_end_date>])  

Parameter

Parameter Definition
expression Ein Ausdruck, der einen Skalarwert zurückgibt.
Datumsangaben Eine Spalte mit Datumsangaben.
filter (optional) Ein Ausdruck, der einen Filter angibt, der auf den aktuellen Kontext angewendet werden soll
year_end_date (optional) Eine Literalzeichenfolge mit einem Datum, das das Enddatum des Jahres definiert. Der Standardwert ist der 31. Dezember.

Rückgabewert

Ein Skalarwert, der den Ausdruck (expression) darstellt, der für die aktuellen dates (Datumsangaben) für „year-to-date“ ausgewertet wird.

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.

  • Für den Ausdruck filter gelten Einschränkungen, die im Thema CALCULATE beschrieben werden.

  • Der Parameter year_end_date ist ein Zeichenfolgenliteral eines Datums in der Sprache des Gebietsschemas des Clients, in dem auch die Arbeitsmappe erstellt wurde. Der Jahresteil des Datums ist nicht erforderlich und wird ignoriert. Die folgende Formel gibt beispielsweise year_end_date (des Geschäftsjahres) in einer Arbeitsmappe mit dem Gebietsschema EN-US als 6/30 an.

    = TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey], ALL('DateTime'), "6/30")  
    

    In diesem Beispiel kann year_end_date als „6/30“, „Jun 30“, „30 June“ oder beliebige Zeichenfolge angegeben werden, die in Monat/Tag aufgelöst wird. Es wird jedoch empfohlen, year_end_date mithilfe von „Monat/Tag“ (wie gezeigt) anzugeben, um sicherzustellen, dass die Zeichenfolge in ein Datum aufgelöst wird.

  • 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 ein „laufendes Jahresergebnis“ oder eine „laufende Jahressumme“ für Internetumsätze berechnet.

= TOTALYTD(SUM(InternetSales_USD[SalesAmount_USD]),DateTime[DateKey])  

ALL
CALCULATE
DATESYTD
TOTALMTD
TOTALQTD