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

yearstart - fonction de script et fonction de graphique

Cette fonction renvoie un horodatage correspondant au début du premier jour de l'année contenant l'argument date. Le format de sortie par défaut correspond à l'argument DateFormat défini dans le script.

 

YearStart(date[, period_no[, first_month_of_year]])

En d'autres termes, la fonction yearstart() détermine l'année dans laquelle tombe la date. Elle renvoie ensuite un horodatage, au format date, pour la première milliseconde de cette année. Le premier mois de l'année est, par défaut, le mois de janvier ; cependant, vous pouvez modifier le mois défini comme le premier en utilisant l'argument first_month_of_year dans la fonction yearstart().

Diagramme de la fonction yearstart() montrant la plage de temps que la fonction peut couvrir.

Diagramme montrant que la fonction yearstart() identifie les dates au cours d'une période annuelle donnée et renvoie l'horodatage du début de l'année pour les dates qui tombent dans cette année donnée.

La fonction yearstart() est utilisée dans le cadre d'une expression lorsque vous souhaitez que le calcul utilise la fraction de l'année qui s'est écoulée jusqu'ici. Par exemple, si vous souhaitez calculer les intérêts accumulés au cours d'une année jusqu'à ce jour.

double

Arguments
Argument Description
date Date ou horodatage à évaluer.
period_no period_no est un entier, où la valeur 0 indique l'année comprenant l'argument 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.

Les mois suivants peuvent être utilisés dans l'first_month_of_year argument :

Valeurs first_month_of_year
Mois Valeur
Février  2
Mars 3
Avril 4
Mai 5
Juin 6
Juillet 7
Août 8
Septembre 9
Octobre 10
Novembre  11
Décembre 12

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.

Exemples de fonction
Exemple Résultat
yearstart('10/19/2001') Renvoie 01/01/2001 00:00:00.
yearstart('10/19/2001',-1) Renvoie 01/01/2000 00:00:00.
yearstart('10/19/2001',0,4) Renvoie 04/01/2001 00:00:00.

Exemple 1 – exemple de base

Exemple 2 – period_no

Exemple 3 – first_month_of_year

Exemple 4 – Exemple d'objet graphique

Exemple 5 – 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 !