WORKDAY

返回指定工作日数之前或之后日期的序列号。

语法

expression.WORKDAY(arg1, arg2, arg3);

expression - 表示 ApiWorksheetFunction 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
arg1	必需	ApiRange | ApiName | number		表示开始日期的序列日期数字。
arg2	必需	ApiRange | ApiName | number		开始日期之前或之后的非周末和非假日天数。正数表示未来日期；负数表示过去日期。
arg3	可选	ApiRange | ApiName | number[]		要从工作日历中排除的一个或多个序列日期数字的可选区域或数组，如州假日、联邦假日和浮动假日。

返回值

number

示例

查找电子表格中给定日期之前或之后指定工作日数的日期。

// How do I calculate a new date by adding or subtracting workdays in a spreadsheet?

// Determine a future or past workday date based on a number of working days in a spreadsheet.

const worksheet = Api.GetActiveSheet();

let func = Api.WorksheetFunction;
let ans = func.WORKDAY("12/7/1981", 56); 

worksheet.GetRange("C1").SetValue(ans);