Script 1.8.1

writeExcel

原型:

writeExcel(excelName, sheetName, startColId, startRowId, dataArr)

描述:

将二维数组写入到 excel 文件中指定 sheet 的指定位置。注意,只能将二维数组写入到 Excel 文件中的一个全新的 sheet 中,会自动创建一个新的 sheet 表。


参数:

excelName:字符串,要写入的 excel 文件名
sheetName:字符串,要写入的 sheet 名
startColId:要写入的起始列号,注意,该序号从 0 开始,3 表示我们将从第四列写入数组内容
startRowId:要写入的起始行号,注意,该序号从 0 开始,4 表示我们将从第五行写入数组内容
dataArr:二维数组,要写入的矩阵数据内容。dataArr 中的每行数据成员无需有相同的数量

返回值:

布尔值,成功返回 true
若有异常发生,返回 false, 可通过 lastError() 函数获取具体的错误信息。

示例:
//定义要写入 EXCEL 中的数据
var a=["a1", "a2", "a3"];
var b=["b1", "b2", "b3", "b4"];
var c=["c1", "c2", "c3", "c4", "c5"];
var arr=[];
arr[0] = a;
arr[1] = b;
arr[2] = c;
//将二维数组arr中的数据写入文件"E:/sigmaTC/testExcel.xls"中的 "Sheet1"表格,从"Sheet1"表格的2列3行开始输入
var ret = excelUtils.writeExcel("E:/sigmaTC/testExcel.xls", "Sheet1", 1, 2, arr);
if (ret == true) {
    print("Successfully written to excel");
} else {
    print(lastError());
}
运行结果:
//成功写入数据,则输出如下信息,否则输出错误信息
Successfully written to excel

Excel 文件中写入数据后如下图所示:

writeExcel_01.png