# Date Fonction de script et de graphique

Date() formate une expression en tant que date en utilisant le format défini dans les variables système du script de chargement de données, sur le système d'exploitation ou dans une chaîne de format (si précisée).

Syntaxe :

Date(number[, format])

Type de données renvoyé : double

Arguments

| Argument | Description |
| --- | --- |
| number | Nombre à formater. |
| format | Chaîne décrivant le format de la chaîne résultante. Si aucune chaîne de format n'est fournie, le format de date défini dans les variables système du script de chargement de données ou du système d'exploitation est utilisé.<br><br>La fonction `Date` supporte de nombreuses options de format pour différentes structures de date, par exemple :<br><br>​`DD/MM/YYYY`: ​jour/mois/année (par exemple, 15/02/2022)<br><br>​`MM-DD-YYYY`: ​mois-jour-année avec des traits d'union (par exemple, 02-15-2022)<br><br>​`YYYY-MM-DD` : ​année-mois-jour au format ISO (par exemple, 2022-02-15)<br><br>​`D-MMM-YYYY` : ​jour, nom de mois court, année avec des traits d'union (par exemple, 15-Feb-2022)<br><br>`​MMMM YYYY` : ​nom de mois long et année (par exemple, February 2022)<br><br>​`MM/YYYY` : ​mois et année (par exemple, 02/2022)<br><br>​`DD MMMM YYYY` : ​jour, nom de mois long et année (par exemple, 15 February 2022) |

Exemple : Expressions de graphique

| Exemple | Résultat |
| --- | --- |
| `Date( 35648 )` | Renvoie `97-08-06` lorsque le paramètre `DateFormat` est `YY-MM-DD`. |
| `Date( 35648, 'YY.MM.DD' )` | Renvoie `97.08.06` lorsque le paramètre `DateFormat` est `YY-MM-DD`. |
| `Date( '8/6/97', 'YY.MM.DD' )` | Renvoie `NULL` lorsque le paramètre `DateFormat` est `YY-MM-DD`. |

## Exemple - Les bases de Date

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

#### Expression de graphique

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données chargé dans une table de données appelée `Example`.

* Champs suivants dans la table de données :

  * `RowNo`
  * `InputDate`

* Variable `DateFormat`, qui utilise le format `YY-MM-DD`.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :

* ` RowNo
                                       `

* `InputDate`

Créez les mesures suivantes :

* `=Date(InputDate)`, pour afficher la valeur sous forme de date formatée à l'aide des paramètres de la variable `DateFormat`.

* `=Date(InputDate, 'DD.MM.YYYY')`, pour afficher la valeur sous forme de date formatée selon le format fourni dans la fonction.

* `=Date(InputDate, 'YY.MM.DD')`, pour afficher la valeur sous forme de date formatée selon le format fourni dans la fonction.

* `=Num(InputDate)`, pour renvoyer la valeur numérique de la date.

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

Les résultats montrent comment la fonction `Date` peut être utilisée pour afficher et formater des dates. Dans cet exemple, la fonction `DateFormat` est définie comme `YY-MM-DD` dans le script de chargement. Le système s'attend à ce que l'expression de la date utilise ce format. Vous pouvez constater que la valeur de `InputDate` à la ligne 3 (`8/6/97`) ne suit pas ce format ; le système ne la reconnaît donc pas comme une date et renvoie `NULL`.

Dans le script de chargement, remplacez le paramètre `DateFormat` par `SET DateFormat='M/D/YY';` et rechargez les données. La valeur de la ligne 3 correspond maintenant au format prévu. Le système reconnaît qu'il s'agit d'une date valide et la formate en conséquence. Le tableau suivant indique les résultats obtenus avec le nouveau paramètre `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 |

## Exemple - Scénario Date

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

#### Expression de graphique

Vue d'ensemble

Un jeu de données contient des données de ventes qui utilisent le format de date `MM-DD-YYYY`. Vous souhaitez utiliser le format de date `DD/MM/YYYY`.

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section.

Le script de chargement contient :

* Jeu de données chargé dans une table de données appelée `Example`.

* Champs suivants dans la table de données :

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

* Variable `DateFormat`, qui utilise le format `MM/DD/YYYY`.

Script de chargement

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

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension :

* ` Customer
                                       `

Créez les mesures suivantes :

* `=Date(SalesDate ,'DD/MM/YYYY')`, pour afficher la valeur sous forme de date formatée selon le format fourni dans la fonction.

* `=Sum(Amount)`, pour calculer la valeur totale du coût de vente.

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 |

En examinant les résultats, vous pouvez constater que bien que les dates du jeu de données utilisent un format, la fonction `Date` vous permet de présenter ces dates dans un format différent.