DATESBETWEENDATESBETWEEN

Diese Funktion gibt eine Tabelle zurück, die eine Spalte mit Datumsangaben enthält, die mit dem angegebenen Startdatum beginnt und bis zum angegebenen Enddatum fortgesetzt wird.Returns a table that contains a column of dates that begins with a specified start date and continues until a specified end date.

Sie ist als Filter für die CALCULATE-Funktion geeignet.This function is suited to pass as a filter to the CALCULATE function. Verwenden Sie sie, um einen Ausdruck nach einem benutzerdefinierten Datumsbereich zu filtern.Use it to filter an expression by a custom date range.

Hinweis

Wenn Sie mit Standarddatumsintervallen wie Tagen, Monaten, Quartalen oder Jahren arbeiten, empfiehlt es sich, die besser geeignete DATESINPERIOD-Funktion zu verwenden.If you're working with standard date intervals such as days, months, quarters, or years, it's recommended you use the better suited DATESINPERIOD function.

SyntaxSyntax

DATESBETWEEN(<dates>, <start_date>, <end_date>)

ParameterParameters

BenennungTerm DefinitionDefinition
Datendates Eine DatumsspalteA date column.
start_datestart_date Ein Datumsausdruck.A date expression.
end_dateend_date Ein Datumsausdruck.A date expression.

RückgabewertReturn value

Eine Tabelle, die eine einzelne Spalte mit Datumswerten enthältA table containing a single column of date values.

BemerkungenRemarks

  • Im häufigsten Anwendungsfall ist Daten ein Verweis auf die Datumsspalte einer gekennzeichneten Datumstabelle.In the most common use case, dates is a reference to the date column of a marked date table.

  • Wenn Datum_Anfang ein leerer Datumswert ist, ist Datum_Anfang der früheste Wert in der Spalte Daten.If start_date is BLANK, then start_date will be the earliest value in the dates column.

  • Wenn Datum_Ende ein leerer Datumswert ist, ist Datum_Ende der späteste Wert in der Spalte Daten.If end_date is BLANK, then end_date will be the latest value in the dates column.

  • Datumsangaben, die als Datum_Anfang und Datum_Ende verwendet werden, sind eingeschlossen.Dates used as the start_date and end_date are inclusive. Wenn der Wert von Datum_Anfang z. B. der 1. Juli 2019 ist, taucht dieses Datum in der zurückgegebenen Tabelle auf (sofern das Datum in der Spalte Daten vorhanden ist).So, for example, if the start_date value is July 1, 2019, then that date will be included in the returned table (providing the date exists in the dates column).

  • Die zurückgegebene Tabelle kann nur Datumswerte enthalten, die in der Spalte Daten gespeichert sind.The returned table can only contain dates stored in the dates column. Wenn die Spalte Daten z. B. am 1. Juli 2017 beginnt und der Wert von Datum_Anfang der 1. Juli 2016 ist, beginnt die zurückgegebene Tabelle am 1. Juli 2017.So, for example, if the dates column starts from July 1, 2017, and the start_date value is July 1, 2016, the returned table will start from July 1, 2017.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

BeispielExample

In der folgenden Measuredefinition der Sales-Tabelle wird die DATESBETWEEN-Funktion verwendet, um eine Life-to-Date-Berechnung (LTD) zu erzeugen.The following Sales table measure definition uses the DATESBETWEEN function to produce a life-to-date (LTD) calculation. Bei einer Life-to-Date-Berechnung wird die Akkumulation eines Measures im Laufe der Zeit ab dem Beginn dargestellt.Life-to-date represents the accumulation of a measure over time since the very beginning of time.

Beachten Sie, dass die Formel die MAX-Funktion verwendet.Notice that the formula uses the MAX function. Diese Funktion gibt das letzte Datum zurück, das sich im Filterkontext befindet.This function returns the latest date that's in the filter context. Die DATESBETWEEN-Funktion gibt folglich eine Tabelle mit Datumsangaben vom frühesten bis zum spätesten gemeldeten Datum zurück.So, the DATESBETWEEN function returns a table of dates beginning from the earliest date until the latest date being reported.

Die Beispiele in diesem Artikel können dem Beispielmodell für Power BI Desktop hinzugefügt werden. Informationen zum Abrufen des Modells finden Sie unter DAX-Beispielmodell.Examples in this article can be added to the Power BI Desktop sample model. To get the model, see DAX sample model.

Customers LTD =
CALCULATE(
    DISTINCTCOUNT(Sales[CustomerKey]),
    DATESBETWEEN(
        'Date'[Date],  
        BLANK(),  
        MAX('Date'[Date])  
    )
)

Beachten Sie, dass das früheste in der Tabelle Daten gespeicherte Datum der 1. Juli 2017 ist.Consider that the earliest date stored in the Date table is July 1, 2017. Wenn ein Bericht das Measure nach dem Monat Juni 2020 filtert, gibt die DATESBETWEEN-Funktion folglich einen Datumsbereich vom 1. Juli 2017 bis zum 30. Juni 2020 zurück.So, when a report filters the measure by the month of June 2020, the DATESBETWEEN function returns a date range from July 1, 2017 until June 30, 2020.

Siehe auchSee also