Python Excel操作模块XlsxWriter之写入数组公式worksheet.write_array_formula()

worksheet.write_array_formula()

write_array_formula(first_row, first_col, last_row, last_col, formula[, cell_format[, value]])

向工作表单元格写入数组公式。

参数：

• first_row(int) - 选区的第一行。（索引全是从0开始计数）
• first_col(int) - 选区的第一列。
• last_row(int) - 选区的最后一行。
• last_col(int) - 选区的最后一列。
• formula(string) - 写入单元格的数组公式。
• cell_format(Format) - 可选的格式对象。
• value -  可选的结果。公式计算后的值。

write_array_formula()方法向单元格选区内写入数组公式。在Excel里数组公式是指向一组值执行计算的公式。它可以返回单个值或者一系列值。

数组公式的特征的是公式两边由一对花括号包围： {=SUM(A1:B1*A2:B2)}。

对于返回一系列值的数组公式，你必须明确地指定返回值写到哪个区域：

worksheet.write_array_formula('A1:A3',    '{=TREND(C1:C3,B1:B3)}')
worksheet.write_array_formula(0, 0, 2, 0, '{=TREND(C1:C3,B1:B3)}')

如果数组公式返回的是单个值，那么第一个（first_）和最后一个（last_）参数应当是一样的：

worksheet.write_array_formula('A1:A1', '{=SUM(B1:C1*B2:C2)}')

然而，在这种情况下，直接使用write_formula()或write()方法更容易：

# 和上面的例子一样但更简洁。
worksheet.write('A1', '{=SUM(B1:C1*B2:C2)}')
worksheet.write_formula('A1', '{=SUM(B1:C1*B2:C2)}')

如上所示，行-列和A1表示法都支持。

cell_format参数用于向单元格应用格式。这个参数是可选的，但在使用时，它必须是一个有效的格式对象。

如有需要，指定公式的计算结果也是可行的（请看之前write_formula()方法中对于公式和value参数的讨论）。然而，使用此参数只会将单个值写入结果数组的左上角单元格。

例：数组公式

这是一个返回一个或多个返回值的数组公式的例子。

#######################################################################
#
# Example of how to use Python and the XlsxWriter module to write
# simple array formulas.
#
# Copyright 2013-2017, John McNamara, jmcnamara@cpan.org
#
import xlsxwriter

# 创建一个新工作簿文件并添加一个工作表
workbook = xlsxwriter.Workbook('array_formula.xlsx')
worksheet = workbook.add_worksheet()

# 写入一些测试数据。
worksheet.write('B1', 500)
worksheet.write('B2', 10)
worksheet.write('B5', 1)
worksheet.write('B6', 2)
worksheet.write('B7', 3)
worksheet.write('C1', 300)
worksheet.write('C2', 15)
worksheet.write('C5', 20234)
worksheet.write('C6', 21003)
worksheet.write('C7', 10000)


# 写入一个返回单个值的数组公式
worksheet.write_formula('A1', '{=SUM(B1:C1*B2:C2)}')

# 和上面的例子一样但更冗长
worksheet.write_array_formula('A2:A2', '{=SUM(B1:C1*B2:C2)}')

# 写入一个返回一系列值的数组公式
worksheet.write_array_formula('A5:A7', '{=TREND(C5:C7,B5:B7)}')

workbook.close()