# yearend - fonction de script et fonction de graphique

Cette fonction renvoie une valeur correspondant à un horodatage de la dernière milliseconde du dernier 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.

Syntaxe :

YearEnd( date[, period\_no[, first\_month\_of\_year = 1]])

**Type de données renvoyé :** double

Arguments :

Arguments YearEnd

| Argument | Description |
| --- | --- |
| date | Date à é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. |

Exemples et résultats :

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

Exemple 1:

`yearend ( '19/10/2001' )`

Renvoie 31/12/2001 23:59:59.

Exemple 2:

`yearend ( '19/10/2001', -1 )`

Renvoie 31/12/2000 23:59:59.

Exemple 3:

`yearend ( '19/10/2001', 0, 4)`

Renvoie 31/03/2002 23:59:59.

Exemple 4:

Ajoutez l'exemple de script à votre document et exécutez-le. Ensuite, ajoutez au moins les champs répertoriés dans la colonne des résultats à une feuille de votre document afin de visualiser le résultat.

Cet exemple permet de rechercher le dernier jour de l'année de chaque date de facture dans la table, où le premier mois de l'année est défini comme le mois numéro 4.

`TempTable:` `LOAD RecNo() as InvID, * Inline [` `InvDate` `28/03/2012` `10/12/2012` `5/2/2013` `31/3/2013` `19/5/2013` `15/9/2013` `11/12/2013` `2/3/2014` `14/5/2014` `13/6/2014` `7/7/2014` `4/8/2014` `];` ` ` `InvoiceData:` `LOAD *,` `YearEnd(InvDate,  0, 4) AS YrEnd` `Resident TempTable;`

`Drop table TempTable;`

La table résultante présente les dates initiales et une colonne contenant la valeur de retour de la fonction yearend(). Vous pouvez afficher l'horodatage complet en spécifiant le formatage dans les propriétés du graphique.

Résultats de l'exemple 4

| InvDate | YrEnd |
| --- | --- |
| 28/03/2012 | 31/03/2011 |
| 10/12/2012 | 31/03/2012 |
| 5/2/2013 | 31/03/2013 |
| 31/3/2013 | 31/03/2013 |
| 19/5/2013 | 31/03/2014 |
| 15/9/2013 | 31/03/2014 |
| 11/12/2013 | 31/03/2014 |
| 2/3/2014 | 31/03/2014 |
| 14/5/2014 | 31/03/2015 |
| 13/6/2014 | 31/03/2015 |
| 7/7/2014 | 31/03/2015 |
| 4/8/2014 | 31/03/2015 |