Cette fonction renvoie une valeur d'affichage représentant la plage des mois de la période (formatée d'après la variable de script MonthNames) de même que l'année. La valeur numérique sous-jacente correspond à un horodatage de la première milliseconde du mois, de la période de deux mois, du trimestre, de la période de quatre mois ou du semestre contenant une date de référence.
MonthsName(n_months, date[, period_no[, first_month_of_year]])
Type de données renvoyé : double
| Argument | Description |
|---|---|
| n_months | Nombre de mois définissant la période. Entier ou expression qui aboutit à un entier devant correspondre à l'une des valeurs suivantes : 1 (équivalant à la fonction inmonth()), 2 (période de deux mois), 3 (équivalant à la fonction inquarter()), 4 (période de quatre mois) ou 6 (semestre). |
| date | Date à évaluer. |
| period_no | Il est possible de décaler la période à l'aide de l'argument period_no, d'un entier ou d'une expression aboutissant à un entier, où la valeur 0 indique la période comprenant l'argument base_date. Les valeurs négatives spécifiées pour period_no indiquent les périodes passées tandis que les valeurs positives désignent les périodes à 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. |
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.
monthsname(4, '19/10/2013')
Renvoie Sep-Dec 2013.
Car, dans cet exemple comme dans les autres, l'instruction SET Monthnames est définie sur Jan;Feb;Mar, etc.
monthsname(4, '19/10/2013', -1)
Renvoie May-Aug 2013.
monthsname(4, '19/10/2013', 0, 2)
Renvoie Oct-Jan 2014.
Étant donné que l'année est spécifiée comme devant commencer au mois numéro 2, la période de quatre mois se termine le premier mois de l'année suivante.
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.
Dans cet exemple, pour chaque date de facture figurant dans la table, le nom des mois est créé à partir de la plage de mois de la période de deux mois et à partir de l'année. La plage est décalée de 4x2 mois si period_no est défini sur 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 *,
MonthsName(2, InvDate, 4) AS MthsName
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 monthsname().
| InvDate | MthsName |
|---|---|
| 28/03/2012 | Nov-Dec 2012 |
| 10/12/2012 | Jul-Aug 2013 |
| 5/2/2013 | Sep-Oct 2013 |
| 31/3/2013 | Nov-Dec2013 |
| 19/5/2013 | Jan-Feb 2014 |
| 15/9/2013 | May-Jun 2014 |
| 11/12/2013 | Jul-Aug 2014 |
| 2/3/2014 | Nov-Dec 2014 |
| 14/5/2014 | Jan-Feb 2015 |
| 13/6/2014 | Jan-Feb 2015 |
| 7/7/2014 | Mar-Apr 2015 |
| 4/8/2014 | Mar-Apr 2015 |
