TOTALYTD
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.
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])