DATE

  • Artikel

Gilt für:Berechnete SpalteBerechnete TabelleMeasureVisuelle Berechnung

Gibt das angegebene Datum im datetime-Format zurück.

Syntax

DATE(<year>, <month>, <day>)

Parameter

Begriff Definition
Jahr Eine Zahl, die das Jahr darstellt.

Der Wert für das year-Argument kann aus ein bis vier Ziffern bestehen. Das year-Argument wird entsprechend dem vom Computer verwendeten Datumssystem interpretiert.

Es werden Datumsangaben ab dem 1. März 1900 unterstützt.

Wenn Sie eine Zahl mit Dezimalstellen eingeben, wird die Zahl gerundet.

Für Werte größer als 9999 oder kleiner als 0 (negative Werte) gibt die Funktion einen #VALUE!-Fehler zurück.

Wenn der year-Wert zwischen 0 und 1899 liegt, wird der Wert zur Generierung des endgültigen Werts zu 1900 addiert. Beispiele hierzu finden Sie weiter unten. Hinweis: Zur Vermeidung unerwünschter Ergebnisse sollten Sie für das year-Argument nach Möglichkeit vier Ziffern verwenden. Mit 07 wird beispielsweise 1907 als Wert für das Jahr zurückgegeben.
month Eine Zahl, die den Monat oder eine Berechnung gemäß den folgenden Regeln darstellt:

Negative ganze Zahlen werden nicht unterstützt. Gültige Werte: 1–12.

Wenn month eine Zahl zwischen 1 und 12 ist, stellt sie einen Monat des Jahres dar. 1 stellt den Januar dar, 2 den Februar usw. bis zur 12, die den Dezember darstellt.

Wenn Sie eine ganze Zahl größer als 12 eingeben, wird das Datum durch Addition der Werte month und year berechnet. Wenn Sie beispielsweise „DATE( 2008, 18, 1)“ eingeben, gibt die Funktion einen datetime-Wert zurück, der dem 1. Juni 2009 entspricht, denn zum Beginn des Jahres 2008 werden 18 Monate addiert, was den Wert „Juni 2009“ ergibt. Siehe folgende Beispiele.
day Eine Zahl, die den Tag oder eine Berechnung gemäß den folgenden Regeln darstellt:

Negative ganze Zahlen werden nicht unterstützt. Gültige Werte: 1–31.

Wenn es sich bei day um eine Zahl zwischen 1 und dem letzten Tag des angegebenen Monats handelt, stellt sie einen Tag des Monats dar.

Wenn Sie eine ganze Zahl größer als der letzte Tag des angegebenen Monats eingeben, wird das Datum durch Addition der Werte day und month berechnet. In der Formel DATE( 2008, 3, 32) gibt die DATE-Funktion beispielsweise einen datetime-Wert zurück, der dem 1. April 2008 entspricht, denn zum Beginn des Monats März werden 32 Tage addiert, was den Wert „1. April“ ergibt.

Wenn day Nachkommastellen enthält, wird der Wert auf den nächsten ganzzahligen Wert gerundet.

Rückgabewert

Gibt das angegebene Datum (datetime) zurück.

Bemerkungen

  • Die DATE-Funktion generiert das entsprechende Datum mithilfe der ganzen Zahlen, die als Argumente eingegeben werden. Die DATE-Funktion ist in Situationen besonders nützlich, in denen Jahr, Monat und Tag durch Formeln bereitgestellt werden. Die zugrunde liegenden Daten können beispielsweise Datumsangaben in einem Format enthalten, das nicht als Datum erkannt wird, z. B. JJJMMTT. Sie können die DATE-Funktion zusammen mit anderen Funktionen verwenden, um die Datumsangaben in eine Zahl zu konvertieren, die als Datum erkannt werden kann.

  • Im Gegensatz zu Microsoft Excel, bei dem Datumsangaben als Seriennummer gespeichert werden, geben DAX-Datumsfunktionen immer einen datetime- Datentyp zurück. Bei Bedarf können Sie Datumsangaben jedoch so formatieren, dass sie als Seriennummern angezeigt werden.

  • Date und datetime können auch als Literal im Format dt"YYYY-MM-DD", dt"YYYY-MM-DDThh:mm:ss" oder dt"YYYY-MM-DD hh:mm:ss" angegeben werden. Bei Angabe als Literal ist die Verwendung der DATE-Funktion im Ausdruck nicht erforderlich. Weitere Informationen finden Sie unter DAX-Syntax: Datum und Uhrzeit.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.

Beispiele

Einfaches Datum

Die folgende Formel gibt das Datum 8. Juli 2009 zurück:

= DATE(2009,7,8)

Jahre vor 1899

Wenn der Wert, den Sie für das year-Argument eingeben, zwischen 0 (Null) und 1899 (einschließlich) eingeben, wird das Jahr durch Addition dieses Werts und 1900 berechnet. Die folgende Formel gibt den 2. Januar 1908 (1900+08) zurück:

= DATE(08,1,2)

Jahre nach 1899

Wenn year zwischen 1900 und 9999 (einschließlich) liegt, wird dieser Wert als Jahr verwendet. Die folgende Formel gibt das Datum 2. Januar 2008 zurück:

= DATE(2008,1,2)

Monate

Wenn month größer als 12 ist addiert month die Anzahl dieser Monate zum ersten Monat des angegebenen Jahres. Die folgende Formel gibt das Datum 2. Februar 2009 zurück:

= DATE(2008,14,2)

Tage

Wenn day größer als die Anzahl von Tagen im angegebenen Monat ist, addiert day diese Anzahl von Tagen zum ersten Tag im Monat. Die folgende Formel gibt das Datum 4. Februar 2008 zurück:

= DATE(2008,1,35)

Zugehöriger Inhalt

Datums- und Uhrzeitfunktionen
DAY-Funktion
TODAY-Funktion