Questa funzione restituisce un indicatore temporale corrispondente all'inizio del primo giorno dell'anno contenente date. Il formato di output predefinito sarà il formato DateFormat impostato nello script.
period_no è un numero intero, in cui il valore 0 indica l'anno che contiene date. I valori negativi di period_no indicano gli anni precedenti, mentre i valori positivi indicano gli anni 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
yearstart ('19/10/2001')
Restituisce 01/01/2001.
yearstart ('19/10/2001', -1)
Restituisce 01/01/2000.
yearstart ('19/10/2001', 0, 4)
Restituisce 01/04/2001.
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.
Questo esempio individua il primo giorno nell'anno relativo a ogni data della fattura nella tabella, in cui il primo mese dell'anno viene specificato come mese 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 *,
YearStart(InvDate, 0, 4) AS YrStart
Resident TempTable;
Drop table TempTable;
La tabella risultante contiene le date originali e una colonna con il valore restituito della funzione yearstart(). È possibile visualizzare l'indicatore temporale completo specificando la formattazione nel pannello delle proprietà.