Questa funzione restituisce un valore di visualizzazione che rappresenta l'intervallo dei mesi del periodo (formattati in base alla variabile di script MonthNames) e l'anno. Il valore numerico sottostante corrisponde a un indicatore temporale recante il primo millisecondo del mese, del bimestre, del trimestre, del quadrimestre o del semestre contenente una data di base.
Il numero di mesi che definisce il periodo. Un numero intero o un'espressione la cui risoluzione è un numero intero corrispondente a: 1 (equivalente alla funzione inmonth()), 2 (bimestre), 3 (equivalente alla funzione inquarter()), 4 (quadrimestre) o 6 (semestre).
date
La data da valutare.
period_no
Il periodo può essere differito mediante period_no, un numero intero, o un'espressione la cui risoluzione è un numero intero, in cui il valore 0 indica il periodo che contiene base_date. I valori negativi di period_no indicano i periodi precedenti, mentre i valori positivi indicano i periodi successivi.
first_month_of_year
Se si intende utilizzare anni (fiscali) che non iniziano a gennaio, indicare un valore compreso tra 2 e 12 in first_month_of_year.
In questi esempi viene utilizzato il formato della data DD/MM/YYYY. Il formato della data viene specificato nell'istruzione SET DateFormat nella parte superiore dello script di caricamento dei dati. Modificare il formato negli esempi in base alle proprie necessità.
Esempi di script
Esempio
Risultato
monthsname(4, '19/10/2013')
Restituisce 'Sep-Dec 2013. Poiché in questo e in altri esempi, l'istruzione SET Monthnames è impostata su Jan;Feb;Mar e così via.
monthsname(4, '19/10/2013', -1)
Restituisce 'May-Aug 2013.
monthsname(4, '19/10/2013', 0, 2)
Restituisce Oct-Jan 2014. Dato che l'inizio dell'anno è stato specificato a partire dal mese 2, il periodo di quattro mesi terminerà il primo mese dell'anno successivo.
Example:
Aggiungere lo script di esempio all'app ed eseguirlo. Aggiungere quindi a un foglio nell'app almeno i campi elencati nella colonna dei risultati per visualizzare il risultato.
In questo esempio, per ogni data della fattura nella tabella, il nome dei mesi viene creato a partire dall'intervallo dei mesi nel periodo bimestrale e dall'anno. L'intervallo viene differito di 4x2 specificando period_no come 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 tabella risultante contiene le date originali e una colonna con il valore restituito della funzione monthsname().