yearend - script and chart function

This function returns a value corresponding to a timestamp of the last millisecond of the last day of the year containing date. The default output format will be the DateFormat set in the script.

Syntax:  

YearEnd( date[, period_no[, first_month_of_year = 1]])

Return data type: dual

Arguments:  

Examples and results:

These examples use the date format DD/MM/YYYY. The date format is specified in the SET DateFormat statement at the top of your data load script. Change the format in the examples to suit your requirements.

Scripting examples

Example	Result
yearend ( '19/10/2001' )	Returns 31/12/2001 23:59:59.
yearend ( '19/10/2001', -1 )	Returns 31/12/2000 23:59:59.
yearend ( '19/10/2001', 0, 4)	Returns 31/03/2002 23:59:59.

Example:  

Add the example script to your app and run it. To see the result, add the fields listed in the results column to a sheet in your app.

This example finds the final day in the year of each invoice date in the table, where the first month in the year is specified as month 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 *,

YearEnd(InvDate, 0, 4) AS YrEnd

Resident TempTable;

Drop table TempTable;

The resulting table contains the original dates and a column with the return value of the yearend() function. You can display the full timestamp by specifying the formatting in the properties panel.