Accéder au contenu principal Passer au contenu complémentaire

yeartodate - fonction de script et fonction de graphique

Cette fonction permet de déterminer si l'horodatage tombe dans l'année de la date à laquelle le script a été chargé pour la dernière fois et renvoie True si c'est le cas ou False si ce n'est pas le cas.

 

YearToDate(timestamp[ , yearoffset [ , firstmonth [ , todaydate] ] ])

booléen

Note Informations

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 fonction yeartodate()

Diagramme affichant les valeurs date pour lesquelles la fonction yeartodate renverra une valeur True ou False.

Si aucun des paramètres facultatifs n'est utilisé, l'année en cours correspond à toute date comprise dans une année calendaire, qui s'étend du 1er janvier à la date de la dernière exécution du script comprise.

En d'autres termes, la fonction yeartodate(), lorsqu'elle est déclenchée sans aucun paramètre supplémentaire, est utilisée pour évaluer un horodatage et renvoyer un résultat booléen selon que la date est tombée pendant l'année civile jusqu'à la date d'actualisation incluse.

Cependant, il est également possible de remplacer la date de début de l'année via l'argument firstmonth, ainsi que d'effectuer des comparaisons avec des années précédentes ou suivantes via l'argument yearoffset.

Pour finir, dans les cas d'ensembles de données historiques, la fonction yeartodate() fournit un paramètre pour définir todaydate, qui, à la place, comparera l'horodatage à l'année civile jusqu'à la date incluse fournie dans l'argument todaydate.

Arguments
Argument Description
timestamp

Horodatage à évaluer, par exemple '10/12/2012'.

yearoffset

En spécifiant une valeur pour yearoffset, yeartodate renvoie True pour la même période d'une autre année. Un décalage yearoffset négatif indique une année antérieure tandis qu'un décalage positif indique une année ultérieure. La valeur year-to-date la plus récente est obtenue en spécifiant yearoffset = -1. Si cette valeur est omise, 0 est défini par défaut.

firstmonth

Si on spécifie un argument firstmonth compris entre 1 et 12 (1 si l'argument est omis), il est possible de déplacer le début de l'année au premier jour de n'importe quel mois. Par exemple, si vous souhaitez travailler avec un exercice financier commençant le 1er mai, spécifiez firstmonth = 5. Une valeur 1 indiquerait un exercice financier commençant le 1er janvier et une valeur 12 un exercice financier commençant le 1er décembre.

todaydate Vous pouvez déplacer le jour utilisé comme limite supérieure de la période en indiquant une date todaydate (horodatage de la dernière exécution du script si l'argument est omis).

Cas d'utilisation

La fonction yeartodate() 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 que la date évaluée s'est produite ou non au cours de l'année jusqu'à la date, incluse, du dernier chargement de l'application.

Par exemple, la fonction YearToDate() peut être utilisée pour identifier l'ensemble des équipements fabriqués jusqu'à présent au cours de l'année en cours.

Dans les exemples suivants, nous supposons que la date du dernier chargement = 11/18/2011.

Exemples de fonction
Exemple Résultat
yeartodate( '11/18/2010') renvoie False
yeartodate( '02/01/2011') renvoie True
yeartodate( '11/18/2011') renvoie True
yeartodate( '11/19/2011') renvoie False
yeartodate( '11/19/2011', 0, 1, '12/31/2011') renvoie True
yeartodate( '11/18/2010', -1) renvoie True
yeartodate( '11/18/2011', -1) renvoie False
yeartodate( '04/30/2011', 0, 5) renvoie False
yeartodate( '05/01/2011', 0, 5) renvoie True

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 – exemple de base

Exemple 2 – yearoffset

Exemple 3 – firstmonth

Exemple 4 – todaydate

Exemple 5 – exemple objet graphique

Exemple 6 – scénario

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 !