businessYearEnd

Syntax

businessYearEnd(X, [endingMonth=12], [offset], [n=1])

Arguments

X is a scalar/vector of data type DATE, DATEHOUR, DATETIME, TIMESTAMP or NANOTIMESTAMP.

endingMonth is an integer between 1 and 12 indicating a month. The default value is 12.

offset is a scalar of the same data type as X, It must be no greater than the minimum value of X. The default value is the minimum value of X.

n is a positive integer. The default value is 1.

Details

Return the last business day (Monday to Friday) of the year that X belongs to and that ends in the month of endingMonth.

If parameter offset is specified, the result is updated every n years. Parameter offset works only if parameter n>1.

Examples

$ businessYearEnd(2012.06.12, 3);
2013.03.29

$ businessYearEnd(2012.06.12, 9);
2012.09.28

$ businessYearEnd(2012.06.12);
2012.12.31

$ businessYearEnd(2012.06.12, 12, 2009.04.03, 2);
2013.12.31

$ date=2011.04.25+(1..10)*365
$ time = take(09:30:00, 10)
$ sym = take(`MSFT,10)
$ price= 49.6 29.46 29.52 30.02 174.97 175.23 50.76 50.32 51.29 52.38
$ qty = 2200 1900 2100 3200 6800 5400 1300 2500 8800 4500
$ t1 = table(date, time, sym, qty, price);

$ t1;

date	time	sym	qty	price
2012.04.24	09:30:00	MSFT	2200	49.6
2013.04.24	09:30:00	MSFT	1900	29.46
2014.04.24	09:30:00	MSFT	2100	29.52
2015.04.24	09:30:00	MSFT	3200	30.02
2016.04.23	09:30:00	MSFT	6800	174.97
2017.04.23	09:30:00	MSFT	5400	175.23
2018.04.23	09:30:00	MSFT	1300	50.76
2019.04.23	09:30:00	MSFT	2500	50.32
2020.04.22	09:30:00	MSFT	8800	51.29
2021.04.22	09:30:00	MSFT	4500	52.38

select avg(price),sum(qty) from t1 group by businessYearEnd(date, 4, 2010.04.01, 2);

businessYearEnd_date	avg_price	sum_qty
2012.04.30	49.6	2200
2014.04.30	29.49	4000
2016.04.29	102.495	10000
2018.04.30	112.995	6700
2020.04.30	50.805	11300
2022.04.29	52.38	4500

Related functions: businessYearBegin, yearBegin, yearEnd