monthEnd

语法

monthEnd(X, [offset], [n=1])

详情

用于计算 X 所在月份的最后一天。

默认情况下,函数按一个月的周期计算。如果指定了 offsetn,且 n > 1,则函数按长度为 n 个月的周期计算。此时,offset 用于确定多月周期的对齐方式:系统会先计算出 offset 所在月份的最后一天,然后以该日期为基准,每隔 n 个月生成一个周期结束边界,并返回 X 所属周期对应的结束日期。

参数

X 可以是 DATE, DATEHOUR, DATETIME, TIMESTAMP 或 NANOTIMESTAMP 类型的标量、向量或表。

offset 是与 X 类型相同的标量,并且它必须小于等于 X 中的最小值。它是一个可选参数。如果没有指定,offset 默认为 X 中的最小值。

n 是一个正整数。它是一个可选参数,默认值为1。当 n 大于 1 时,必须同时指定 offset

返回值

DATE 类型标量或向量。

例子

monthEnd(2016.12.06);
// output: 2016.12.31

date=2016.04.12 2016.04.25 2016.05.12 2016.06.28 2016.07.10 2016.07.18 2016.08.02 2016.08.16 2016.09.26 2016.09.30
time = [09:34:07,09:36:42,09:36:51,09:36:59,09:32:47,09:35:26,09:34:16,09:34:26,09:38:12,09:38:13]
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);

select avg(price),sum(qty) from t1 group by monthEnd(date,2016.01.01,2);
monthEnd_date avg_price sum_qty
2016.05.31 36.193333 6200
2016.07.31 126.74 15400
2016.09.30 51.1875 17100

相关函数:monthBegin, businessMonthBegin, businessMonthEnd, semiMonthBegin, semiMonthEnd