inyeartodate - fonction de script et fonction de graphique

Cette fonction renvoie la valeur True si l'argument timestamp se trouve dans la partie de l'année comprenant l'argument base_date jusqu'à la dernière milliseconde spécifiée dans base_date.

InYearToDate (timestamp, base_date, period_no[, first_month_of_year])

booléen

Dans Qlik Sense, la valeur booléenne true est représentée par -1 et la valeur false par 0.

Exemple de diagramme de la plage de dates dans laquelle la fonction inyeartodate renverra une valeur TRUE. — Diagramme de la fonction inyeartodate

La fonction inyeartodate() segmentera une portion donnée de l'année avec base_date, identifiant la date maximale autorisée pour ce segment d'année. La fonction évalue ensuite si un champ ou une valeur de date tombe dans ce segment et renvoie un résultat booléen.

Arguments
Argument	Description
timestamp	Date à comparer à base_date.
base_date	Date utilisée pour évaluer l'année.
period_no	Il est possible de décaler l'année à l'aide de l'argument period_no. period_no est un entier, où la valeur 0 indique l'année comprenant l'argument base_date. Les valeurs négatives de l'argument period_no indiquent les années passés tandis que les valeurs positives désignent les années à venir.
first_month_of_year	Si vous voulez utiliser des exercices (financiers) qui ne commencent pas en janvier, indiquez une valeur comprise entre 2 et 12 dans l'argument first_month_of_year.

Cas d'utilisation

La fonction inyeartodate() renvoie un résultat booléen. Ce type de fonction sera généralement utilisé comme condition dans une expression if. Cela renverrait une agrégation ou un calcul suivant qu'une date évaluée s'est produite ou non au cours de l'année jusqu'à la date en question incluse.

Par exemple, la fonction inyeartodate() peut être utilisée pour identifier l'ensemble des équipements fabriqués au cours d'une année jusqu'à une date spécifique.

Ces exemples utilisent le format de date MM/DD/YYYY. Le format de date est indiqué dans l'instruction SET DateFormat située en haut de votre script de chargement de données. Modifiez le format utilisé dans les exemples en fonction de vos exigences.

Exemples de fonction
Exemple	Résultat
inyeartodate ('01/25/2013', '02/01/2013', 0)	Renvoie TRUE.
inyeartodate ('01/25/2012', '01/01/2013', 0)	Renvoie FALSE.
inyeartodate ('01/25/2012', '02/01/2013', -1)	Renvoie TRUE.
inyeartodate ('11/25/2012', '01/31/2013', 0, 4)	Renvoie TRUE. La valeur de timestamp tombe pendant l'exercice fiscal débutant au quatrième mois et avant la valeur définie par base_date.
inyeartodate ('3/31/2013', '01/31/2013', 0, 4 )	Renvoie FALSE. Par comparaison avec l'exemple précédent, la valeur de timestamp est toujours comprise dans l'exercice fiscal, mais elle se trouve après la valeur de base_date. Elle tombe donc en dehors de la partie de l'année spécifiée.

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.

Si vous êtes un créateur d'applications, vous pouvez définir la région par défaut des applications que vous créez. Pour plus d'informations, voir Sélection des paramètres régionaux de votre choix pour la création d'applications et de scripts dans Qlik Cloud Analytics.

Exemple 1 – aucun argument supplémentaire

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 contenant un ensemble de transactions entre 2020 et 2022, chargé dans une table appelée Transactions.
Champ de date fourni dans la variable système DateFormat au format (MM/DD/YYYY).
Création d'un champ, in_year_to_date, qui détermine les transactions qui ont eu lieu au cours de l'année jusqu'au 26 juillet 2021.

Script de chargement

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', 0) as in_year_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'07/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
];

Résultats

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

date
in_year_to_date

Tableau de résultats
date	in_year_to_date
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
06/14/2020	0
08/07/2020	0
09/05/2020	0
01/22/2021	-1
02/03/2021	-1
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Le champ in_year_to_date est créé dans l'instruction preceding load à l'aide de la fonction inyeartodate(). Le premier argument fourni identifie le champ en cours d'évaluation.

Le deuxième argument est une date codée en dur du 26 juillet 2021, qui est la valeur base_date qui identifie la limite de fin du segment d'année. Une valeur period_no égale à 0 constitue l'argument final, ce qui signifie que la fonction ne compare pas les années précédant ou suivant l'année segmentée.

Diagramme indiquant la plage de dates pour laquelle la fonction inyeartodate renverra une valeur TRUE. — Diagramme de la fonction inyeartodate, sans argument supplémentaire

Toute transaction qui se produit entre le 1er janvier et le 26 juillet renvoie un résultat booléen TRUE. Les dates de transactions avant 2021 et au-delà du 26 juillet 2021 renvoient FALSE.

Exemple 2 – period_no

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 :

Même ensemble de données et même scénario que ceux du premier exemple.
Création d'un champ, previous_year_to_date, qui détermine les transactions qui ont eu lieu une année complète avant la fin du segment d'année le 26 juillet 2021.

Script de chargement

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', -1) as previous_year_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'07/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
];

Résultats

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

date
previous_year_to_date

Tableau de résultats
date	previous_year_to_date
01/13/2020	-1
02/26/2020	-1
03/27/2020	-1
04/16/2020	-1
05/21/2020	-1
06/14/2020	-1
08/07/2020	0
09/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	0
04/23/2021	0
05/04/2021	0
06/30/2021	0
07/26/2021	0
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Une valeur period_no égale à -1 indique que la fonction inyeartodate () compare le segment de trimestre d'entrée à l'année précédente. Avec une date d'entrée du 26 juillet 2021, le segment du 1er janvier 2021 au 26 juillet 2021 a été initialement identifié comme le résultat de l'année jusqu'à la date en cours. La valeur period_no décale ensuite ce segment d'une année complète plus tôt, faisant passer les limites de date à la période du 1er janvier au 26 juillet 2020.

Par conséquent, toute transaction effectuée entre le 1er janvier et le 26 juillet 2020 renverra un résultat booléen TRUE.

Exemple 3 – first_month_of_year

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 :

Même ensemble de données et même scénario que ceux du premier exemple.
Création d'un champ, in_year_to_date, qui détermine les transactions qui ont eu lieu au cours de la même année jusqu'au 26 juillet 2021.

Dans cet exemple, nous définissons mars comme le premier mois de l'exercice financier.

Script de chargement

SET DateFormat='MM/DD/YYYY';

Transactions:
    Load
        *,
        inyeartodate(date,'07/26/2021', 0,3) as in_year_to_date
        ;
Load
*
Inline
[
id,date,amount
8188,'01/13/2020',37.23
8189,'02/26/2020',17.17
8190,'03/27/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'06/14/2020',82.06
8194,'08/07/2020',40.39
8195,'09/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'07/27/2021',25.12
8204,'06/06/2022',46.23
8205,'07/18/2022',84.21
8206,'11/14/2022',96.24
8207,'12/12/2022',67.67
];

Résultats

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

date
in_year_to_date

Tableau de résultats
date	in_year_to_date
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
06/14/2020	0
08/07/2020	0
09/05/2020	0
01/22/2021	0
02/03/2021	0
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

Si on utilise 3 comme argument first_month_of_year dans la fonction inyeartodate(), la fonction commence l'année le 1er mars. La valeur base_date du 26 juillet 2021 définit ensuite la date de fin de ce segment d'année-là.

Par conséquent, toute transaction qui se produit entre le 1er mars et le 26 juillet 2021 renverra un résultat booléen TRUE, tandis que les transactions avec des dates en dehors de ces limites renverront une valeur FALSE.

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.

Le script de chargement contient le même ensemble de données et le même scénario que ceux du premier exemple. Cependant, dans cet exemple, le même ensemble de données est chargé dans l'application. Le calcul qui détermine les transactions qui ont eu lieu la même année jusqu'au 26 juillet 2021 est créé sous forme de mesure dans un objet graphique de l'application.

Script de chargement

SET DateFormat='MM/DD/YYYY';

Transactions: 
Load 
* 
Inline  
[ 
id,date,amount 
8188,'01/13/2020',37.23 
8189,'02/26/2020',17.17 
8190,'03/27/2020',88.27 
8191,'04/16/2020',57.42 
8192,'05/21/2020',53.80 
8193,'06/14/2020',82.06 
8194,'08/07/2020',40.39 
8195,'09/05/2020',87.21 
8196,'01/22/2021',95.93 
8197,'02/03/2021',45.89 
8198,'03/17/2021',36.23 
8199,'04/23/2021',25.66 
8200,'05/04/2021',82.77 
8201,'06/30/2021',69.98 
8202,'07/26/2021',76.11 
8203,'07/27/2021',25.12 
8204,'06/06/2022',46.23 
8205,'07/18/2022',84.21 
8206,'11/14/2022',96.24 
8207,'12/12/2022',67.67
];

Résultats

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

Créez la mesure suivante :

=inyeartodate(date,'07/26/2021', 0)

Tableau des résultats
date	=inyeartodate(date,'07/26/2021', 0)
01/13/2020	0
02/26/2020	0
03/27/2020	0
04/16/2020	0
05/21/2020	0
06/14/2020	0
08/07/2020	0
09/05/2020	0
01/22/2021	-1
02/03/2021	-1
03/17/2021	-1
04/23/2021	-1
05/04/2021	-1
06/30/2021	-1
07/26/2021	-1
07/27/2021	0
06/06/2022	0
07/18/2022	0
11/14/2022	0
12/12/2022	0

La mesure in_year_to_date est créée dans l'objet graphique à l'aide de la fonction inyeartodate(). Le premier argument fourni identifie le champ en cours d'évaluation. Le deuxième argument est une date codée en dur du 26 juillet 2021, qui est la valeur base_date qui identifie la limite de fin du segment d'année du comparateur. Une valeur period_no égale à 0 constitue l'argument final, ce qui signifie que la fonction ne compare pas les années précédant ou suivant l'année segmentée.

Toute transaction qui se produit entre le 1er janvier et le 26 juillet 2021 renvoie un résultat booléen TRUE. Les dates de transactions avant 2021 et après le 26 juillet 2021 renvoient FALSE.

Exemple 5 – scénario

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 chargé dans une table appelée Products.
Informations concernant l'ID du produit, le type de produit, la date de fabrication et le prix de revient.

L'utilisateur final souhaite un objet graphique qui affiche, par type de produit, le coût des produits fabriqués en 2021 jusqu'au 26 juillet.

Script de chargement

Products:
Load
*
Inline
[
product_id,product_type,manufacture_date,cost_price
8188,product A,'01/13/2020',37.23
8189,product B,'02/26/2020',17.17
8190,product B,'03/27/2020',88.27
8191,product C,'04/16/2020',57.42
8192,product D,'05/21/2020',53.80
8193,product D,'08/14/2020',82.06
8194,product C,'10/07/2020',40.39
8195,product B,'12/05/2020',87.21
8196,product A,'01/22/2021',95.93
8197,product B,'02/03/2021',45.89
8198,product C,'03/17/2021',36.23
8199,product C,'04/23/2021',25.66
8200,product B,'05/04/2021',82.77
8201,product D,'06/30/2021',69.98
8202,product D,'07/26/2021',76.11
8203,product D,'12/27/2021',25.12
8204,product C,'06/06/2022',46.23
8205,product C,'07/18/2022',84.21
8206,product A,'11/14/2022',96.24
8207,product B,'12/12/2022',67.67
];

Résultats

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

Créez une mesure qui calcule la somme de chaque produit fabriqué en 2021 avant le 27 juillet :

=sum(if(inyeartodate(manufacture_date,makedate(2021,07,26),0),cost_price,0))

Définissez le Formatage des nombres des mesures sur Money (Devise).

Tableau de résultats
product_type	=sum(if(inyeartodate(manufacture_date,makedate(2021,07,26),0),cost_price,0))
product A	$95.93
product B	$128.66
product C	$61.89
product D	$146.09

La fonction inyeartodate() renvoie une valeur booléenne lors de l'évaluation des dates de fabrication de chacun des produits. Pour tout produit fabriqué en 2021 avant le 27 juillet, la fonction inyeartodate() renvoie une valeur booléenne TRUE et additionne la valeur cost_price.

Product D est le seul produit également fabriqué après le 26 juillet 2021. L'entrée product_ID 8203 a été fabriquée le 27 décembre et a coûté $25.12. Par conséquent, ce coût n'a pas été inclus dans le total de Product D dans l'objet graphique.

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