yearBegin
Syntax
yearBegin(X, [startingMonth=1], [offset], [n=1])
Arguments
X is a scalar/vector of data type DATE, DATEHOUR, DATETIME, TIMESTAMP or NANOTIMESTAMP.
startingMonth is an integer between 1 and 12 indicating a month. The default value is 1.
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 first day of the year that X belongs to and that starts in the month of startingMonth.
If parameter offset is specified, the result is updated every n years. Parameter offset works only if parameter n>1.
Examples
$ yearBegin(2012.06.12, 10);
2011.10.01
$ yearBegin(2012.06.12, 4);
2012.04.01
$ yearBegin(2012.06.12);
2012.01.01
$ yearBegin(2012.06.12, 1, 2009.04.03, 2);
2011.01.01
$ 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 yearBegin(date, 10, 2010.10.01, 2);
yearBegin_date |
avg_price |
sum_qty |
|---|---|---|
2010.10.01 |
49.6 |
2200 |
2012.10.01 |
29.49 |
4000 |
2014.10.01 |
102.495 |
10000 |
2016.10.01 |
112.995 |
6700 |
2018.10.01 |
50.805 |
11300 |
2020.10.01 |
52.38 |
4500 |
Related functions: yearEnd, businessYearBegin, businessYearEnd