# Date Skript- und Diagrammfunktion

Date() formatiert eine Formel als Datum und verwendet dafür das vorgegebene Format aus den Systemvariablen des Datenladeskripts, des Betriebssystems oder eines Formatcodes, wenn dieser zur Verfügung steht.

Syntax:

Date(number[, format])

Rückgabe Datentyp: dual

Argumente

| Argument | Beschreibung |
| --- | --- |
| number | Die zu formatierende Zahl. |
| format | String, der das Format des entstehenden Strings beschreibt. Wenn kein Formatstring geliefert wird, wird das in den Systemvariablen des Datenladeskripts oder im Betriebssystem festgelegte Datumsformat verwendet.<br><br>Die Funktion `Date` unterstützt viele Formatoptionen für verschiedene Datumsstrukturen, zum Beispiel:<br><br>​`DD/MM/YYYY`:​Tag/Monat/Jahr (zum Beispiel 15/02/2022)<br><br>​`MM-DD-YYYY`: ​Monat-Tag-Jahr mit Bindestrichen (zum Beispiel 02-15-2022)<br><br>​`YYYY-MM-DD`: ​Jahr-Monat-Tag, ISO-Format (zum Beispiel 2022-02-15)<br><br>​`D-MMM-YYYY`: ​Tag, kurzer Monatsname, Jahr, mit Bindestrichen (zum Beispiel 15-Feb-2022)<br><br>`​MMMM YYYY`: ​Langer Monatsname und Jahr (zum Beispiel February 2022)<br><br>​`MM/YYYY`: ​Monat und Jahr (zum Beispiel 02/2022)<br><br>​`DD MMMM YYYY`: ​Tag, langer Monatsname und Jahr (zum Beispiel 15 February 2022) |

Beispiel: Diagrammformeln

| Beispiel | Ergebnis |
| --- | --- |
| `Date( 35648 )` | Gibt `97-08-06` zurück, wenn die Einstellung `DateFormat` `YY-MM-DD` ist. |
| `Date( 35648, 'YY.MM.DD' )` | Gibt `97.08.06` zurück, wenn die Einstellung `DateFormat` `YY-MM-DD` ist. |
| `Date( '8/6/97', 'YY.MM.DD' )` | Gibt `NULL` zurück, wenn die Einstellung `DateFormat` `YY-MM-DD` ist. |

## Beispiel – Grundlegendes zu „Date“

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Date.htm)

#### Diagrammformel

Übersicht

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.

Das Ladeskript umfasst:

* Datensatz, der in eine Datentabelle namens `Example` geladen wird

* Die folgenden Felder in der Datentabelle:

  * `RowNo`
  * `InputDate`

* Die Variable `DateFormat`, die das Format `YY-MM-DD` verwendet.

Ladeskript

```
SET DateFormat='YY-MM-DD';
Example:
Load * inline [
RowNo, InputDate
1, 35648
2, 35648.375
3, 8/6/97
];
```

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie die folgenden Felder als Dimensionen hinzu:

* ` RowNo
                                       `

* `InputDate`

Erstellen Sie die folgenden Kennzahlen:

* `=Date(InputDate)`, um den Wert als Datum anzuzeigen, das mit den Einstellungen der Variablen `DateFormat` formatiert wurde.

* `=Date(InputDate, 'DD.MM.YYYY')`, um den Wert als Datum anzuzeigen, das mit dem in der Funktion angegebenen Format formatiert ist.

* `=Date(InputDate, 'YY.MM.DD')`, um den Wert als Datum anzuzeigen, das mit dem in der Funktion angegebenen Format formatiert ist.

* `=Num(InputDate)`, um den numerischen Wert des Datums zurückzugeben.

Results table

| RowNo | InputDate | Date(InputDate) | Date(InputDate, 'DD.MM.YYYY') | Date(InputDate, 'YY.MM.DD') | Num(InputDate) |
| --- | --- | --- | --- | --- | --- |
| 1 | 35648 | 97-08-06 | 06.08.1997 | 97.08.06 | 35648 |
| 2 | 35648.375 | 97-08-06 | 06.08.1997 | 97.08.06 | 35648.375 |
| 3 | 8/6/97 | - | - | - | - |

Die Ergebnisse zeigen, wie die Funktion `Date` zur Anzeige und Formatierung von Datumsangaben verwendet werden kann. In diesem Beispiel ist das `DateFormat` im Ladeskript als `YY-MM-DD` festgelegt. Das System erwartet, dass die Formel für das Datum dieses Format verwendet. Sie sehen, dass der Wert für `InputDate` in Zeile 3 (`8/6/97`) nicht diesem Format folgt. Daher erkennt das System ihn nicht als Datum und gibt `NULL` zurück.

Ändern Sie die Einstellung `DateFormat` im Ladeskript in `SET DateFormat='M/D/YY';` und laden Sie die Daten erneut. Der Wert in Zeile 3 entspricht nun dem erwarteten Format. Das System erkennt ihn als gültiges Datum und formatiert ihn entsprechend. Die folgende Tabelle zeigt die Ergebnisse mit der neuen Einstellung für `DateFormat`.

Results table with variable statement `Set DateFormat='M/D/YY'`Set DateFormat='M/D/YY'

| RowNo | InputDate | Date(InputDate) | Date(InputDate, 'DD.MM.YYYY') | Date(InputDate, 'YY.MM.DD') | Num(InputDate) |
| --- | --- | --- | --- | --- | --- |
| 1 | 35648 | 97-08-06 | 06.08.1997 | 97.08.06 | 35648 |
| 2 | 35648.375 | 97-08-06 | 06.08.1997 | 97.08.06 | 35648.375 |
| 3 | 35648 | 97-08-06 | 06.08.1997 | 97.08.06 | 35648.375 |

## Beispiel – Szenario für „Date“

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/FormattingFunctions/Date.htm)

#### Diagrammformel

Übersicht

Ein Datensatz enthält Umsatzdaten, die das Datumsformat `MM-DD-YYYY` verwenden. Sie möchten das Datumsformat `DD/MM/YYYY` verwenden.

Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein.

Das Ladeskript umfasst:

* Datensatz, der in eine Datentabelle namens `Example` geladen wird

* Die folgenden Felder in der Datentabelle:

  * `Customer`
  * `SalesDate`
  * `Amount`

* Die Variable `DateFormat`, die das Format `MM/DD/YYYY` verwendet.

Ladeskript

```
SET DateFormat='MM/DD/YYYY';
Example:
Load * inline [
Customer, SalesDate, Amount
Customer A, 2/15/2024, 100008
Customer B, 9/30/2024, 12500
Customer C, 12/28/2024, 15000
];
```

Ergebnisse

Laden Sie die Daten und öffnen Sie ein Arbeitsblatt. Erstellen Sie eine neue Tabelle und fügen Sie dieses Feld als Dimension hinzu:

* ` Customer
                                       `

Erstellen Sie die folgenden Kennzahlen:

* `=Date(SalesDate ,'DD/MM/YYYY')`, um den Wert als Datum anzuzeigen, das mit dem in der Funktion angegebenen Format formatiert ist.

* `=Sum(Amount)`, um den Gesamtwert der Umsatzkosten zu berechnen.

Results table

| Customer | Date(SalesDate ,'DD/MM/YYYY') | Sum(Amount) |
| --- | --- | --- |
| Customer A | 15/02/2024 | 100008 |
| Customer B | 30/09/2024 | 12500 |
| Customer C | 28/12/2024 | 15000 |

Wenn Sie sich die Ergebnisse ansehen, können Sie feststellen, dass die Datumsangaben im Datensatz zwar ein bestimmtes Format verwenden, die Funktion `Date` es Ihnen jedoch ermöglicht, diese Datumsangaben in einem anderen Format darzustellen.