『Python - Xlwings』如何方便快捷地在Excel中输入附带单元格格式的DataFrame

2022年10月，$xlwings$ 更新了0.28.1版本，其中 $Range方法$ 新增了一个参数 $formatter$，它能十分方便地实现该功能
$env$: $\to$ $xlsings==$ 0.28.1

使用方法

sht['A1'].options(index=False, header=True, formatter=values_formatter).value = DataFrame

---

实操代码

import xlwings as xw
import pandas as pd
value_lis = [['Group_1', Timestamp('2021-06-02 00:00:00'), 50000000.0, nan, 0.0757725117], ['Group_2', Timestamp('2021-10-29 00:00:00'), 10588235.0, nan, 0.0141176466], ['Group_3', Timestamp('2021-10-29 00:00:00'), 35294118.0, 6393.93, 0.0135072739], ['Group_4', Timestamp('2021-10-29 00:00:00'), 14117647.0, 1562.91, 0.0135072737]]
show_df = pd.DataFrame(data=value_lis, columns=['Name', 'Date', 'Value_1', 'Value_2', 'Value_3'])

def values_formatter(rng: xw.Range, df: pd.DataFrame):
    format_dict = {'Name': "General", 'Date': "[$-409]d-mmm-yy;@", 'Value_1': "#,##0.0,,",
                   'Value_2': '_(* #,##0.00_);_(* (#,##0.00);_(* "-"??_);_(@_)', 'Value_3': "0.00%"}
    for ix, col in enumerate(df.columns):
        rng[0:, ix].number_format = format_dict[col]

app = xw.App(visible=True, add_book=False)
app.display_alerts = False
app.screen_updating = True
wb = app.books.open(r'C:\Showing\show.xlsx')
sheet = wb.sheets['Sheet1']

# 输入不带单元格格式的df
sheet['A3'].options(index=False, header=True).value = show_df
# 输入附带单元格格式的df
sheet['A9'].options(index=False, header=True, formatter=values_formatter).value = show_df
sheet.autofit('c')

输出效果

不难看出，函数 $values\_formatter$ 把映射字典($column\_name$：$format\_detail$)传给了formatter参数，从而快捷地为 $DataFrame$ 中的每一列都设置相应的单元格格式

🔺：经测试，发现盗版excel可能无法使用该方法 XD