FORECAST_ETS

使用指数平滑 (ETS) 算法的 AAA 版本，根据现有（历史）值计算或预测未来值。

语法

expression.FORECAST_ETS(arg1, arg2, arg3, arg4, arg5, arg6);

expression - 表示 ApiWorksheetFunction 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
arg1	必需	ApiRange | ApiName | number		将预测新值的日期。必须在时间线中的最后一个日期之后。
arg2	必需	ApiRange | ApiName | number[]		确定将预测新点的历史值的数值数据区域或数组。
arg3	必需	ApiRange | ApiName		与历史值对应的日期/时间值区域。时间线区域必须与第二个参数大小相同。日期/时间值之间必须有恒定的步长，且不能为零。
arg4	可选	ApiRange | ApiName | number		指定季节性模式长度的可选数值。默认值 1 表示自动检测季节性。值 0 表示没有季节性。
arg5	可选	ApiRange | ApiName | number		处理缺失值的可选数值。默认值 1 通过插值替换缺失值，0 则用零替换。
arg6	可选	ApiRange | ApiName | number		用于聚合具有相同时间戳的多个值的可选数值。

返回值

number

示例

此示例演示如何使用 AAA 版本的指数平滑 (ETS) 算法根据现有（历史）值计算或预测未来值。

// How to calculate or predict a future value based on existing (historical) values.

// Use an AAA version of the Exponential Smoothing (ETS) algorithm to calculate or predict a future value based on existing values.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
let dates = ["10/1/2017", "11/1/2017", "12/1/2017", "1/1/2018", "2/1/2018", "3/1/2018"];
let numbers = [12558, 14356, 16345, 18678, 14227];

for (let i = 0; i < dates.length; i++) {
    worksheet.GetRange("A" + (i + 1)).SetValue(dates[i]);
}
for (let j = 0; j < numbers.length; j++) {
    worksheet.GetRange("B" + (j + 1)).SetValue(numbers[j]);
}

worksheet.GetRange("A1").SetColumnWidth(15);
let range1 = worksheet.GetRange("B1:B5");
let range2 = worksheet.GetRange("A1:A5");
worksheet.GetRange("B6").SetValue(func.FORECAST_ETS("3/1/2018", range1, range2, 0, 1, 1));