使用 Python 设置 Excel 数字显示格式

在自动化生成报表时，我们往往更关注“数据是否正确”，却忽略了一个同样重要的问题——数据是否易读、是否专业、是否符合业务习惯。同样的数字，在不同的显示格式下，带给读者的理解体验是完全不同的。千分位分隔可以提升可读性，红色负数可以强化风险提示，括号表示法符合财务规范，而日期与时间格式则直接影响数据的语义表达。

在 Excel 中，这一切都由数字显示格式控制。通过 Python 操作 Excel 文件时，我们同样可以精确设置这些显示规则，而无需依赖 Microsoft Office。本篇文章将围绕一个完整示例，在同一张工作表中演示多种常见数字格式的设置方式，并解释每种格式代码背后的逻辑。

本文示例基于 Free Spire.XLS for Python，可通过pip安装：pip install spire.xls.free。

1. 初始化工作簿与表头结构

首先创建工作簿，并在工作表中设置示例区域结构。

from spire.xls import *
from spire.xls.common import *

# 创建工作簿
workbook = Workbook()

# 获取第一个工作表
sheet = workbook.Worksheets.get_Item(0)
sheet.Name = "数字格式演示"

# 设置表头
sheet.Range["B5"].Text = "格式说明"
sheet.Range["C5"].Text = "原始数值"
sheet.Range["D5"].Text = "格式化显示"

这里特别需要注意的是：
Excel 的数字格式只会作用于“数值类型”数据，因此必须使用 NumberValue 写入数值，而不是 Text。否则格式代码不会生效。

2. 千分位与小数位控制

在财务或销售报表中，大数值如果不加分隔符，会严重影响可读性。

sheet.Range["B6"].Text = "千分位 + 两位小数"
sheet.Range["C6"].Text = "9876543.219"
sheet.Range["D6"].NumberValue = 9876543.219
sheet.Range["D6"].NumberFormat = "#,##0.00"

#,##0.00 表示使用千分位分隔，并始终保留两位小数。
其中 # 代表可选数字位，而 0 表示必须占位，即使为 0 也会显示。

3. 负数以红色显示

在财务场景中，负值往往需要视觉强调。

sheet.Range["B7"].Text = "负数红色显示"
sheet.Range["C7"].Text = "-4567.8"
sheet.Range["D7"].NumberValue = -4567.8
sheet.Range["D7"].NumberFormat = "[Red]#,##0.00"

方括号中的 [Red] 是条件格式的一种表达方式。
当数值为负时，会自动以红色显示，增强警示效果。

4. 百分比格式

百分比在增长率、完成率等场景中非常常见。

sheet.Range["B8"].Text = "百分比（1位小数）"
sheet.Range["C8"].Text = "0.8765"
sheet.Range["D8"].NumberValue = 0.8765
sheet.Range["D8"].NumberFormat = "0.0%"

当使用 % 符号时，Excel 会自动将数值乘以 100 后显示。
0.0% 表示保留一位小数。

5. 负数使用括号表示

在标准财务报表中，负数通常用括号表示，而不是负号。

sheet.Range["B9"].Text = "负数括号表示"
sheet.Range["C9"].Text = "-3200"
sheet.Range["D9"].NumberValue = -3200
sheet.Range["D9"].NumberFormat = "#,##0;(#,##0)"

分号 ; 用于区分不同数值类型的格式。
第一部分表示正数格式，第二部分表示负数格式。
因此负值会显示为 (3,200)。

6. 日期格式控制

Excel 中的日期本质是一个序列号。通过设置格式，可以改变显示方式。

sheet.Range["B10"].Text = "日期格式"
sheet.Range["C10"].Text = "44927"
sheet.Range["D10"].NumberValue = 44927
sheet.Range["D10"].NumberFormat = "yyyy-mm-dd"

/ 或 - 用于分隔年、月、日。
yyyy-mm-dd 是常见的标准日期格式。

7. 时间格式

时间在 Excel 中以 1 表示 24 小时，因此 0.75 表示一天的 75%。

sheet.Range["B11"].Text = "时间格式"
sheet.Range["C11"].Text = "0.75"
sheet.Range["D11"].NumberValue = 0.75
sheet.Range["D11"].NumberFormat = "hh:mm:ss"

这里的 hh:mm:ss 控制小时、分钟和秒的显示方式。

8. 货币格式（欧元示例）

货币格式通常需要带符号并保留小数位。

sheet.Range["B12"].Text = "欧元货币"
sheet.Range["C12"].Text = "2500.5"
sheet.Range["D12"].NumberValue = 2500.5
sheet.Range["D12"].NumberFormat = "€#,##0.00"

$ 或 € 等符号可以直接写入格式字符串。
在实际应用中也可以结合系统区域设置自动适配。

9. 科学计数法

在处理大规模数据或科研数据时，科学计数法更便于阅读。

sheet.Range["B13"].Text = "科学计数法"
sheet.Range["C13"].Text = "987654321"
sheet.Range["D13"].NumberValue = 987654321
sheet.Range["D13"].NumberFormat = "0.00E+00"

E+00 表示指数形式，0.00 控制有效数字位数。

10. 数值前添加文本说明

有时我们希望数值带有说明文字，但仍保持可计算性。

sheet.Range["B14"].Text = "带文本前缀"
sheet.Range["C14"].Text = "1500"
sheet.Range["D14"].NumberValue = 1500
sheet.Range["D14"].NumberFormat = "\"销售额:\" #,##0"

双引号用于包裹固定文本，数值仍然是数值类型。

11. 自动调整与保存文件

sheet.AllocatedRange.Style.Font.Size = 12
sheet.AllocatedRange.AutoFitRows()
sheet.AllocatedRange.AutoFitColumns()

workbook.SaveToFile("SetNumberFormatPython.xlsx", FileFormat.Version2016)
workbook.Dispose()

生成 Excel 文件预览

下图是使用以上代码生成的 Excel 文件的预览效果：

常见 NumberFormat 代码说明

总结

数字格式并不会改变数据本身，它改变的是“数据如何被理解”。在自动化报表系统中，数据的准确性固然重要，但展示的专业性同样决定了报表质量。通过合理使用 NumberValue 与 NumberFormat，我们可以在保持数据可计算性的前提下，实现高度定制化的显示效果。

当报表开始面向客户、财务人员或管理层时，数字格式不再只是技术细节，而是沟通质量的一部分。熟练掌握这一能力，会让你的自动化报表系统真正达到专业级水准。

更多 Excel 文件操作技巧请前往 Spire.XLS for Python 官方教程查看。