DateFormat

Cette variable d'environnement définit le format de date utilisé par défaut dans l'application et par date renvoyant des fonctions comme date() et date#(). Le format est utilisé pour interpréter et formater les dates. Si la variable n'est pas définie, le format de date défini par vos paramètres régionaux est récupéré lors de l'exécution du script.

DateFormat

Exemples de fonction DateFormat
Exemple	Résultat
Set DateFormat='M/D/YY'; //(US format)	Cette utilisation de la fonction DateFormat définit la date au format américain, à savoir, mois/jour/année.
Set DateFormat='DD/MM/YY'; //(UK date format)	Cette utilisation de la fonction DateFormat définit la date au format britannique, à savoir, jour/mois/année.
Set DateFormat='YYYY/MM/DD'; //(ISO date format)	Cette utilisation de la fonction DateFormat définit la date au format ISO, à savoir, année/mois/jour.

Paramètres régionaux

Sauf indication contraire, les exemples de cette rubrique utilisent le format de date suivant : MM/JJ/AAAA. Le format de date est indiqué dans l'instruction SET DateFormat de votre script de chargement de données. Le format de date par défaut peut être différent dans votre système en raison de vos paramètres régionaux et d'autres facteurs. Vous pouvez modifier les formats utilisés dans les exemples ci-dessous en fonction de vos besoins. Ou vous pouvez modifier les formats utilisés dans votre script de chargement pour qu'ils correspondent à ceux de ces exemples.

Les paramètres régionaux par défaut des applications sont basés sur les paramètres système régionaux de l'ordinateur ou du serveur sur lequel Qlik Sense est installé. Si le serveur Qlik Sense auquel vous accédez est configuré sur la Suède, l'éditeur de chargement de données utilisera les paramètres régionaux suédois pour les dates, l'heure et la devise. Ces paramètres de format régionaux ne sont pas liés à la langue affichée dans l'interface utilisateur Qlik Sense. Qlik Sense sera affiché dans la même langue que celle du navigateur que vous utilisez.

Exemple 1 – Variables système par défaut

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Ensemble de données de dates.
Fonction DateFormat, qui utilisera le format de date américain.

Dans cet exemple, un ensemble de données est chargé dans une table nommée 'Transactions'. Il inclut un champ date. La définition DateFormat américaine est utilisée. Ce modèle sera utilisé pour la conversion de texte en date implicite lorsque les dates textuelles sont chargées.

Script de chargement


Set DateFormat='MM/DD/YYYY'; 

Transactions: 
LOAD 
date, 
month(date) as month, 
id, 
amount 
INLINE  
[ 
date,id,amount 
01/01/2022,1,1000 
02/01/2022,2,2123 
03/01/2022,3,4124 
04/01/2022,4,2431 
];

Résultats

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

date
month

Créez cette mesure :

=sum(amount)

Tableau de résultats
date	month	=sum(amount)
01/01/2022	Jan	1000
02/01/2022	Feb	2123
03/01/2022	Mar	4124
04/01/2022	Apr	2431

La définition DateFormat MM/DD/YYYY est utilisée pour la conversion implicite de texte en dates. C'est pourquoi le champ date est correctement interprété comme une date. Le même format est utilisé pour afficher la date, comme indiqué dans le tableau de résultats.

Exemple 2 – modification de la variable système

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Le même ensemble de données que dans l'exemple précédent.
La fonction DateFormat, qui utilisera le format ‘DD/MM/YYYY’.

Script de chargement


SET DateFormat='DD/MM/YYYY'; 
Transactions: 
LOAD 
date, 
month(date) as month, 
id, 
amount 
INLINE  
[ 
date,id,amount 
01/01/2022,1,1000 
02/01/2022,2,2123 
03/01/2022,3,4124 
04/01/2022,4,2431 
];

Résultats

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

date
month

Créez cette mesure :

=sum(amount)

Tableau de résultats
date	month	=sum(amount)
01/01/2022	Jan	1000
02/01/2022	Jan	2123
03/01/2022	Jan	4124
04/01/2022	Jan	2431

Étant donné que la définition DateFormat a été déterminée sur ‘DD/MM/YYYY’, vous pouvez voir que les deux chiffres après le premier symbole “/” ont été interprétés comme le mois, ce qui fait que tous les enregistrements proviennent du mois de janvier.

Exemple 3 – interprétation de la date

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Un ensemble de données avec des dates au format numérique.
La variable DateFormat, qui utilisera le format ‘DD/MM/YYYY’.
La variable date().

Script de chargement


SET DateFormat='MM/DD/YYYY'; 
						
Transactions: 
Load 
date(numerical_date), 
month(date(numerical_date)) as month, 
id, 
amount 
Inline  
[ 
numerical_date,id,amount 
43254,1,1000 
43255,2,2123 
43256,3,4124 
43258,4,2431 
];

Résultats

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

date
month

Créez cette mesure :

=sum(amount)

Tableau de résultats
date	month	=sum(amount)
06/03/2022	Jun	1000
06/04/2022	Jun	2123
06/05/2022	Jun	4124
06/07/2022	Jun	2431

Dans le script de chargement, vous utilisez la fonction date() pour convertir la date numérique en un format de date. Étant donné que vous ne fournissez pas de format spécifié comme deuxième argument dans la fonction, le format DateFormat est utilisé. C'est pourquoi le champ de date utilise le format ‘MM/DD/YYYY’.

Exemple 4 – formatage de dates étrangères

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Ensemble de données de dates.
Variable DateFormat, qui utilise le format ‘DD/MM/YYYY', mais qui n'est pas commentée par des barres obliques.

Script de chargement

// SET DateFormat='DD/MM/YYYY'; 

 
Transactions: 
Load 
date, 
month(date) as month, 
id, 
amount 
Inline  
[ 
date,id,amount 
22-05-2022,1,1000 
23-05-2022,2,2123 
24-05-2022,3,4124 
25-05-2022,4,2431 
];

Résultats

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

date
month

Créez cette mesure :

=sum(amount)

Tableau de résultats
date	month	=sum(amount)
22-05-2022	-	1000
23-05-2022	-	2123
24-05-2022	-	4124
25-05-2022	-	2431

Dans le script de chargement initial, le format DateFormat utilisé est le format ‘MM/DD/YYYY’ par défaut. Étant donné que le champ date de l'ensemble de données Transactions ne se présente dans ce format, le champ n'est pas interprété comme une date. Cela apparaît dans le tableau de résultats où les valeurs du champ month sont nulles.

Vous pouvez vérifier les types de données interprétés dans le visionneur de modèle de données en inspectant les propriétés “Tags” du champ date.

Aperçu du tableau 'Transactions', avec les détails du champ 'date' en surbrillance. — Aperçu du tableau Transactions. Notez les "Tags" du champ date indiquant que les données d'entrée textuelles n'ont pas été implicitement converties en date/horodatage.

Cela peut être résolu en activant la variable système DateFormat :

// SET DateFormat='DD/MM/YYYY' ;

Supprimez les doubles barres obliques et actualisez les données.

Aperçu du tableau 'Transactions' après modification de la variable système DateFormat. — Aperçu du tableau Transactions. Notez les "Tags" du champ date indiquant que les données d'entrée textuelles ont été implicitement converties en date/horodatage.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !

Laissez vos commentaires ici