Dernière mise à jour : 07/10/2026
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.
Syntaxe :
MonthsName(n_months, date[, period_no[, first_month_of_year]])
Type de données renvoyé : double
Arguments :
| 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. |
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:
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.
Exemple 2:
monthsname(4, '19/10/2013', -1)
Renvoie May-Aug 2013.
Exemple 3:
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.
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.
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 |
