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. Pour plus d'informations, voir Modification des paramètres régionaux des applications et des scripts.
Les paramètres régionaux par défaut des applications sont basés sur le profil utilisateur. Ces paramètres de format régionaux ne sont pas liés à la langue affichée dans l'interface utilisateur Qlik Cloud. Qlik Cloud sera affiché dans la même langue que celle du navigateur que vous utilisez.
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 champdate. 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.
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.
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 !