Cette fonction renvoie une année composée de quatre chiffres comme valeur d'affichage avec une valeur numérique sous-jacente correspondant à un horodatage de la première milliseconde du premier jour de l'année contenant l'argument date.
YearName(date[, period_no[, first_month_of_year]] )
Type de données renvoyé : double
| 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. La valeur d'affichage sera alors une chaîne indiquant deux années. |
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.
yearname ( '19/10/2001')
Renvoie 2001.
yearname ( '19/10/2001', -1 )
Renvoie '2000.
yearname ( '19/10/2001', 0, 4)
Renvoie '2001-2002.
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 crée un nom composé de quatre chiffres-plus-quatre chiffres pour les années pour lesquelles chaque date de facture figurant dans la table est identifiée. Cela s'explique par le fait que 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 *,
YearName(InvDate, 0, 4) AS YrName
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 yearname().
| InvDate | YrName |
|---|---|
| 28/03/2012 | 2011-2012 |
| 10/12/2012 | 2012-2013 |
| 5/2/2013 | 2012-2013 |
| 31/3/2013 | 2012-2013 |
| 19/5/2013 | 2013-2014 |
| 15/9/2013 | 2013-2014 |
| 11/12/2013 | 2013-2014 |
| 2/3/2014 | 2013-2014 |
| 14/5/2014 | 2014-2015 |
| 13/6/2014 | 2014-2015 |
| 7/7/2014 | 2014-2015 |
| 4/8/2014 | 2014-2015 |
