环境准备
1.1 库安装
通过 pip 安装免费版本：
pip install spire.xls.free安装完成后，在 Python 脚本中导入相关模块即可使用：
from spire.xls import * from spire.xls.common import *1.2 核心概念
Excel 的数字格式作用于数值型数据，仅改变显示外观，不改变单元格的实际存储值。设置格式涉及两个核心属性：
- NumberValue：写入单元格的原始数值（必须为数值类型）
- NumberFormat：格式代码字符串，定义数值的显示规则
注意：若通过
Text属性写入数字字符串，数字格式将不会生效。必须使用NumberValue赋值，才能保证格式正确应用。
二、常用数字格式分类与代码
Excel 数字格式代码遵循四段式结构：正数格式;负数格式;零值格式;文本格式，各段用分号分隔。实际使用中可根据需求省略部分段落。以下分类介绍高频场景。
2.1 常规数值与小数位数
控制小数点后的保留位数，以及是否显示千分位分隔符。
| 格式代码 | 原始值 | 显示效果 | 说明 |
|---|---|---|---|
0 | 1234.56 | 1235 | 整数，四舍五入 |
0.00 | 1234.5 | 1234.50 | 固定两位小数 |
#,##0 | 1234567 | 1,234,567 | 千分位分隔，无小数 |
#,##0.00 | 1234.567 | 1,234.57 | 千分位 + 两位小数 |
代码示例：
sheet.Range["D2"].NumberValue = 1234567.89 sheet.Range["D2"].NumberFormat = "#,##0.00"2.2 货币格式
在数值前添加货币符号，通常配合千分位与小数位使用。
| 格式代码 | 显示效果 |
|---|---|
¥#,##0.00 | ¥1,234.56 |
$#,##0.00 | $1,234.56 |
€ #,##0.00 | € 1,234.56 |
代码示例：
sheet.Range["D4"].NumberValue = 9999.99 sheet.Range["D4"].NumberFormat = "¥#,##0.00"2.3 百分比格式
将小数乘以 100 后以百分比形式展示。
| 格式代码 | 原始值 | 显示效果 |
|---|---|---|
0% | 0.123 | 12% |
0.00% | 0.12345 | 12.35% |
代码示例：
sheet.Range["D6"].NumberValue = 0.12345 sheet.Range["D6"].NumberFormat = "0.00%"2.4 日期与时间格式
Excel 内部以序列值存储日期（1900-01-01 对应数值 1），通过格式代码转换为可读日期。
| 格式代码 | 原始值 | 显示效果 |
|---|---|---|
yyyy-mm-dd | 45566 | 2024-10-01 |
yyyy年m月d日 | 45566 | 2024年10月1日 |
m/d/yyyy | 45566 | 10/1/2024 |
hh:mm:ss | 0.625 | 15:00:00 |
h:mm AM/PM | 0.625 | 3:00 PM |
yyyy-mm-dd hh:mm | 45566.625 | 2024-10-01 15:00 |
代码示例：
sheet.Range["D8"].NumberValue = 45566 sheet.Range["D8"].NumberFormat = "yyyy-mm-dd" sheet.Range["D9"].NumberValue = 0.625 sheet.Range["D9"].NumberFormat = "hh:mm:ss"2.5 科学计数法
适用于极大或极小数值的紧凑展示。
| 格式代码 | 原始值 | 显示效果 |
|---|---|---|
0.00E+00 | 1234567 | 1.23E+06 |
0.00E-00 | 0.0000123 | 1.23E-05 |
2.6 分数格式
以分数形式显示小数。
| 格式代码 | 原始值 | 显示效果 |
|---|---|---|
# ?/? | 0.75 | 3/4 |
# ??/?? | 0.333 | 1/3 |
2.7 条件颜色格式
根据数值正负自动显示不同颜色，方括号内指定颜色名称。
| 格式代码 | 原始值 | 显示效果 |
|---|---|---|
[Green]#,##0;[Red]-#,##0 | 正数绿色，负数红色 | |
[Red]#,##0.00 | 全部显示为红色 |
代码示例：
sheet.Range["D12"].NumberValue = -1234.56 sheet.Range["D12"].NumberFormat = "[Green]#,##0.00;[Red]-#,##0.00"2.8 自定义文本前缀/后缀
在数值前后附加固定文本，同时保持数值可计算性。文本需用双引号包裹。
| 格式代码 | 原始值 | 显示效果 |
|---|---|---|
"合计："#,##0" 元" | 5000 | 合计：5,000 元 |
0" 件" | 120 | 120 件 |
三、完整示例代码
以下示例在同一张工作表中集中演示多种数字格式效果：
from spire.xls import * from spire.xls.common import * # 创建工作簿 workbook = Workbook() sheet = workbook.Worksheets.get_Item(0) sheet.Name = "数字格式示例" # 设置列宽 sheet.SetColumnWidth(2, 22) sheet.SetColumnWidth(3, 15) sheet.SetColumnWidth(4, 20) # 表头 sheet.Range["B2"].Text = "格式说明" sheet.Range["C2"].Text = "原始值" sheet.Range["D2"].Text = "显示结果" header_style = sheet.Range["B2:D2"].Style header_style.Font.IsBold = True header_style.HorizontalAlignment = HorizontalAlignType.Center
