inmonthstodate - funzione dello script e del grafico

Questa funzione stabilisce se un indicatore temporale ricade all'interno della parte di un periodo di un mese, bimestre, trimestre, quadrimestre o semestre fino a includere l'ultimo millisecondo di base_date. È inoltre possibile stabilire se l'indicatore temporale ricade all'interno di un periodo di tempo precedente o successivo.

Syntax:

InMonths (n_months, timestamp, base_date, period_no[, first_month_of_year ])

Return data type: Booleano

Arguments:

Argomento	Descrizione
n_months	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).
timestamp	La data da confrontare con base_date.
base_date	La data utilizzata per valutare il periodo.
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à.

Esempio

Risultato

inmonthstodate(4, '25/01/2013', '25/04/2013', 0)

Restituisce True. Perché il valore di timestamp, 25/01/2013 ricade entro il periodo di quattro mesi 01/01/2013 fino alla fine di 25/04/2013, in cui ricade il valore di base_date, 25/04/2013.

inmonthstodate(4, '26/04/2013', '25/04/2006', 0)

Restituisce False. Perché 26/04/2013 non ricade nello stesso periodo dell'esempio precedente.

inmonthstodate(4, '25/09/2005', '01/02/2006', -1)

Restituisce True. Perché il valore di period_no, -1, fa slittare il periodo della ricerca indietro di quattro mesi (il valore di n-months) e questo cambia il periodo di ricerca da 01/09/2012 in 01/02/2012.

inmonthstodate(4, '25/04/2006', '01/06/2006', 0, 3)

Restituisce True. Perché il valore di first_month_of_year è impostato su 3 e ciò cambia il periodo di ricerca da 01/03/2006 in 01/06/2006 anziché da 01/05/2006 in 01/06/2006.

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 viene verificato se la data della fattura nella tabella ricade nel periodo bimestrale fino a e includendo base_date slittato in avanti di due mesi (mediante la specifica di 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 *,

InMonthsToDate(2, InvDate, '15/02/2013', 4) AS InMths2DPlus4

Resident TempTable;

Drop table TempTable;

La tabella risultante contiene le date originali e una colonna con il valore restituito della funzione InMonths().

Il periodo di ricerca va da 01/09/2013 a 15/10/2013, perché il valore di base_date è slittato in avanti di due mesi dal valore della funzione (15/02/2013).

InvDate	InMths2DPlus4
28/03/2012	0 (False)
10/12/2012	0 (False)
5/2/2013	0 (False)
31/3/2013	0 (False)
19/5/2013	0 (False)
15/9/2013	-1 (True)
11/12/2013	0 (False)
2/3/2014	0 (False)
14/5/2014	0 (False)
13/6/2014	0 (False)
7/7/2014	0 (False)
4/8/2014	0 (False)