# Date Script- en diagramfunctie

Date() maakt een uitdrukking op als een datum met de opmaak die in de systeemvariabelen in het load-script voor gegevens, in het besturingssysteem of in een opmaakreeks is ingesteld, indien opgegeven.

Syntaxis:

Date(number[, format])

Retourgegevenstypen: dubbele waarde

Argumenten

| Argument | Beschrijving |
| --- | --- |
| number | Het getal dat moet worden opgemaakt. |
| format | Tekenreeks waarmee de notatie van de resulterende tekenreeks wordt beschreven. Als er geen opmaakreeks wordt opgegeven, wordt de datumopmaak gebruikt die is ingesteld in de systeemvariabelen in het load-script voor gegevens of in het besturingssysteem.<br><br>De functie `Date` ondersteunt vele opmaakopties voor verschillende datumstructuren, bijvoorbeeld:<br><br>​`DD/MM/YYYY`: ​dag/maand/jaar (bijvoorbeeld 15/02/2022)<br><br>​`MM-DD-YYYY`: ​maand-dag-jaar met koppeltekens (bijvoorbeeld 02-15-2022)<br><br>​`YYYY-MM-DD`: ​jaar-maand-dag, ISO-formaat (bijvoorbeeld 2022-02-15)<br><br>​`D-MMM-YYYY`: ​dag, korte maandnaam, jaar, met koppeltekens (bijvoorbeeld 15-Feb-2022)<br><br>`​MMMM YYYY`: ​lange maandnaam en jaar (bijvoorbeeld February 2022)<br><br>​`MM/YYYY`: ​maand en jaar (bijvoorbeeld 02/2022)<br><br>`DD MMMM YYYY`: ​dag, lange maandnaam en jaar (bijvoorbeeld 15 February 2022) |

Voorbeeld: diagramuitdrukkingen

| Voorbeeld | Resultaat |
| --- | --- |
| `Date( 35648 )` | Retourneert `97-08-06` als de `DateFormat` instelling `YY-MM-DD` is. |
| `Date( 35648, 'YY.MM.DD' )` | Retourneert `97.08.06` als de `DateFormat` instelling `YY-MM-DD` is. |
| `Date( '8/6/97', 'YY.MM.DD' )` | Retourneert `NULL` als de `DateFormat` instelling `YY-MM-DD` is. |

## Voorbeeld - Basisprincipes voor Date

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

#### Diagramuitdrukking

Overzicht

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

* Een gegevensverzameling die wordt geladen in een tabel met de naam `Example`.

* De volgende velden in de gegevenstabel:

  * `RowNo`
  * `InputDate`

* De variabele `DateFormat`, die de notatie `YY-MM-DD` gebruikt.

Load-script

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

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg deze velden toe als dimensies:

* ` RowNo
                                       `

* `InputDate`

Maak de volgende metingen:

* `=Date(InputDate)`, om de waarde weer te geven als een datum die is opgemaakt met behulp van de instellingen van de variabele `DateFormat`.

* `=Date(InputDate, 'DD.MM.YYYY')`, om de waarde weer te geven als een datum die is opgemaakt volgens de notatie die in de functie is opgegeven.

* `=Date(InputDate, 'YY.MM.DD')`, om de waarde weer te geven als een datum die is opgemaakt volgens de notatie die in de functie is opgegeven.

* `=Num(InputDate)` om de numerieke waarde van de datum te retourneren.

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 | - | - | - | - |

De resultaten laten zien hoe de functie `Date` gebruikt kan worden om datums weer te geven en op te maken. In dit voorbeeld wordt de `DateFormat` ingesteld als `YY-MM-DD` in het load-script. Het systeem verwacht dat de uitdrukking voor de datum deze notatie gebruikt. U kunt zien dat de waarde voor `InputDate` in rij 3 (`8/6/97`) deze notatie niet volgt, daarom herkent het systeem het niet als een datum en retourneert het `NULL`.

Verander de instelling `DateFormat` in het load-script in `SET DateFormat='M/D/YY';` en laad de gegevens opnieuw. De waarde in rij 3 komt nu overeen met de verwachte notatie. Het systeem zal dit herkennen als een geldige datum en de datum dienovereenkomstig opmaken. De volgende tabel toont de resultaten met de nieuwe instelling `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 |

## Voorbeeld – Scenario met Date

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

#### Diagramuitdrukking

Overzicht

Een gegevensverzameling bevat verkoopgegevens die de datumnotatie `MM-DD-YYYY` gebruiken. U wilt de datumnotatie `DD/MM/YYYY` gebruiken.

Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie.

Het load-script bevat:

* Een gegevensverzameling die wordt geladen in een tabel met de naam `Example`.

* De volgende velden in de gegevenstabel:

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

* De variabele `DateFormat`, die de notatie `MM/DD/YYYY` gebruikt.

Load-script

```
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
];
```

Resultaten

Laad de gegevens en open een werkblad. Maak een nieuwe tabel en voeg dit veld toe als dimensie:

* ` Customer
                                       `

Maak de volgende metingen:

* `=Date(SalesDate ,'DD/MM/YYYY')` om de waarde weer te geven als een datum die is opgemaakt volgens de notatie die in de functie is opgegeven.

* `=Sum(Amount)` om de totale waarde van de verkoopkosten te berekenen.

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 |

Als u naar de resultaten kijkt, ziet u dat hoewel de datums in de gegevensverzameling één notatie gebruikten, u met de functie `Date` deze datums in een andere notatie kunt presenteren.