year - fonction de script et fonction de graphique
Cette fonction renvoie un entier représentant l'année au cours de laquelle l'expression est interprétée comme une date selon l'interprétation standard des nombres.
year(expression)
entier
La fonction year() est disponible comme fonction de script et de graphique. La fonction renvoie l'année d'une date donnée. Elle est couramment utilisée pour créer un champ year comme dimension dans un Master Calendar.
Cas d'utilisation
La fonction year() est utile lorsque vous souhaitez comparer des agrégations par année. Par exemple, la fonction peut être utilisée si vous souhaitez voir les ventes totales de produits par année.
Il est possible de créer ces dimensions dans le script de chargement via la fonction permettant de créer un champ dans une table Master Calendar. Sinon, elle peut également être directement utilisée dans un graphique comme dimension calculée.
Exemples de fonction
Exemple
Résultat
year(
'2012-10-12' )
renvoie 2012.
year(
'35648' )
renvoie 1997, car 35648 = 1997-08-06.
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.
Exemple 1 – Ensemble de données DateFormat (script)
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, chargé dans une table appelée Master Calendar.
La variable système DateFormat par défaut (MM/DD/YYYY) est utilisée.
Instruction preceding load utilisée pour créer un champ supplémentaire, year, via la fonction year().
Script de chargement
SET DateFormat='MM/DD/YYYY';
Master_Calendar:
Load
date,
year(date) as year
;
Load
date
Inline
[
date
12/28/2020
12/29/2020
12/30/2020
12/31/2020
01/01/2021
01/02/2021
01/03/2021
01/04/2021
01/05/2021
01/06/2021
01/07/2021
];
Résultats
Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :
date
year
Tableau de résultats
date
année
12/28/2020
2020
12/29/2020
2020
12/30/2020
2020
12/31/2020
2020
01/01/2021
2021
01/02/2021
2021
01/03/2021
2021
01/04/2021
2021
01/05/2021
2021
01/06/2021
2021
01/07/2021
2021
Exemple 2 – dates ANSI
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, chargé dans une table appelée Master Calendar.
La variable système DateFormat par défaut (MM/DD/YYYY) est utilisée. Cependant, les dates incluses dans l'ensemble de données sont au format de date standard ANSI.
Chargement précédent, utilisé pour créer un champ supplémentaire, appelé year, via la fonction year().
Script de chargement
SET DateFormat='MM/DD/YYYY';
Master_Calendar:
Load
date,
year(date) as year
;
Load
date
Inline
[
date
2020-12-28
2020-12-29
2020-12-30
2020-12-31
2021-01-01
2021-01-02
2021-01-03
2021-01-04
2021-01-05
2021-01-06
2021-01-07
];
Résultats
Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :
date
year
Tableau de résultats
date
année
2020-12-28
2020
2020-12-29
2020
2020-12-30
2020
2020-12-31
2020
2021-01-01
2021
2021-01-02
2021
2021-01-03
2021
2021-01-04
2021
2021-01-05
2021
2021-01-06
2021
2021-01-07
2021
Exemple 3 – dates non formatées
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, au format numérique, chargé dans une table appelée Master Calendar.
La variable système DateFormat par défaut (MM/DD/YYYY) est utilisée.
Chargement précédent, utilisé pour créer un champ supplémentaire, year, via la fonction year().
La date non formatée originale est chargée, appelée unformatted_date, et, pour clarifier les choses, un autre champ supplémentaire, appelé long_date, est utilisé pour convertir la date numérique en champ de date formatée via la fonction date().
Script de chargement
SET DateFormat='MM/DD/YYYY';
Master_Calendar:
Load
unformatted_date,
date(unformatted_date) as long_date,
year(unformatted_date) as year
;
Load
unformatted_date
Inline
[
unformatted_date
44868
44898
44928
44958
44988
45018
45048
45078
45008
45038
45068
];
Résultats
Chargez les données et ouvrez une feuille. Créez une table et ajoutez ces champs comme dimensions :
unformatted_date
long_date
year
Tableau des résultats
unformatted_date
long_date
année
44868
11/03/2022
2022
44898
12/03/2022
2022
44928
01/02/2023
2023
44958
02/01/2023
2023
44988
03/03/2023
2023
45008
03/23/2023
2023
45018
04/02/2023
2023
45038
04/22/2023
2023
45048
05/02/2023
2023
45068
05/22/2023
2023
45078
06/01/2023
2023
Exemple 4 – Exemple d'objet graphique
Vue d'ensemble
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.
Dans cet exemple, un ensemble de données de commandes passées est chargé dans une table nommée Sales. La table contient trois champs :
id
sales_date
amount
Les garanties sur les ventes de produits au cours des deux dernières années à compter de la date de vente. La tâche consiste à créer une mesure dans un graphique pour déterminer l'année d'expiration de chaque garantie.
Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension : sales_date.
Créez la mesure suivante :
=year(sales_date+365*2)
Tableau de résultats
sales_date
=year(sales_date+365*2)
12/28/2020
2022
12/29/2020
2022
12/30/2020
2022
12/31/2020
2022
01/01/2021
2023
01/02/2021
2023
01/03/2021
2023
01/04/2021
2023
01/05/2021
2023
01/06/2021
2023
01/07/2021
2023
Les résultats de cette mesure sont affichés dans le tableau ci-dessus. Pour ajouter deux années à une date, multipliez 365 par 2 et ajoutez le résultat à la date de vente. Par conséquent, la date d'expiration des ventes qui ont eu lieu en 2020 est 2022.
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 !