C# 数字格式化全攻略：从占位符到快捷字母，一文掌握！

原创于 2026-01-02 19:40:12 发布 · 667 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#c#

C#基础专栏收录该内容

18 篇文章

订阅专栏

在日常开发中，我们经常需要对数字进行格式化输出——无论是显示金额、科学计数、补零对齐，还是转成十六进制。C# 提供了非常灵活且强大的数字格式化机制，只需一个 ToString() 方法配合格式字符串，就能轻松搞定各种需求。

今天，我们就系统梳理一下 C# 中常见的数字格式化转换方式，让你从此告别“手动拼字符串”的原始操作！

一、使用 `"0"` 和 `"#"` 占位符：精准控制位数

这是最基础也最常用的自定义数字格式方式。通过 "0" 和 "#" 两个占位符，我们可以精确控制整数和小数的显示位数。

符号	行为说明
`"0"`	强制占位符。如果实际位数不足，用 `0` 补齐；若小数位超出指定长度，则四舍五入。
`"#"`	可选占位符。仅在有有效数字时显示，不会补 `0`，常用于避免前导零或尾随零。

示例代码：

Console.WriteLine(15.ToString("000"));              // 输出：015
Console.WriteLine(10.456.ToString("0.00"));         // 输出：10.46（四舍五入）
Console.WriteLine(10.456.ToString("00"));           // 输出：10（只保留整数部分）
Console.WriteLine(10.456.ToString("value is 0.0")); // 输出：value is 10.5

💡 小技巧：你甚至可以在格式字符串中嵌入文字（如 "订单: 0000"），实现带描述的输出！

📌 注意：

"0" 会强制显示该位置，即使值为 0；
"#" 在无数字时不显示，例如 123.ToString("#,##0") → 123，而 123.ToString("0,000") → 0,123。

二、内置标准格式：一行代码搞定专业显示

C# 内置了多种标准数字格式字符串（Standard Numeric Format Strings），用单个字母（可选精度参数）即可快速实现常见格式。

格式符	名称	说明	示例
`E`	科学计数法	默认 6 位小数，指数形式	`(25000).ToString("E")` → `2.500000E+004`
`C`	货币	根据当前线程的区域设置自动添加货币符号、千分位、保留 2 位小数	`(2.5).ToString("C")` → `￥2.50`（中文系统）或 `$2.50`（英文系统）
`D`	十进制整数	仅用于整型，可指定最小位数（不足补前导零）	`(25).ToString("D5")` → `00025`
`F`	固定点	保留指定小数位（默认 2 位），不带千分位	`(25).ToString("F2")` → `25.00`
`G`	常规	自动选择最紧凑表示（`F` 或 `E`），保留指定有效数字	`(2.52).ToString("G2")` → `2.5`
`N`	数字	带千分位分隔符，默认保留 2 位小数	`(2500000).ToString("N")` → `2,500,000.00`
`X`	十六进制	仅适用于整数类型（`int`, `long` 等）	`(255).ToString("X")` → `FF`；`(255).ToString("x4")` → `00ff`（小写）

完整示例：

class Program
{
    static void Main()
    {
        Console.WriteLine((25000).ToString("E"));       // 2.500000E+004
        Console.WriteLine((2.5).ToString("C"));         // ￥2.50（取决于 CultureInfo）
        Console.WriteLine((25).ToString("D5"));         // 00025
        Console.WriteLine((25).ToString("F2"));         // 25.00
        Console.WriteLine((2.52).ToString("G2"));       // 2.5
        Console.WriteLine((2500000).ToString("N"));     // 2,500,000.00
        Console.WriteLine((255).ToString("X"));         // FF
        Console.WriteLine((255).ToString("x4"));        // 00ff（小写 + 补零）
    }
}

⚠️ 重要提醒：

X 格式仅支持整数类型，对 double、decimal 使用会抛出 FormatException。
货币符号、千分位分隔符（, 还是空格？）、小数点符号（. 还是 ,？）均受 CultureInfo 影响

如需固定格式，可显式指定文化信息：

 (1234.56).ToString("C", CultureInfo.GetCultureInfo("en-US")); // $1,234.56

三、自定义格式的高级玩法

除了标准格式，你还可以自由组合 "0"、"#", 以及文字、符号、分组分隔符等，打造专属格式。

实用示例：

// 补零 + 文字描述
Console.WriteLine(7.ToString("订单号: 0000"));        // 订单号: 0007

// 控制小数 + 单位
Console.WriteLine(98.765.ToString("温度: 0.0℃"));    // 温度: 98.8℃

// 千分位 + 自定义小数（使用 #,##0.00）
Console.WriteLine(1234567.89.ToString("#,##0.00"));  // 1,234,567.89

// 百分比格式（自动 ×100 并加 %）
Console.WriteLine(0.875.ToString("P1"));            // 87.5%

🔍 千分位说明：
使用 #,##0 表示每三位加一个分隔符（具体符号由区域决定）。
例如在德语环境可能显示为 1.234.567,89。

四、格式化速查表

应用场景	推荐格式	示例输入 → 输出
编号补零（5位）	`"D5"` 或 `"00000"`	`25` → `00025`
显示人民币金额	`"C"`	`123.4` → `￥123.40`
科学数据展示	`"E3"`	`12345` → `1.234E+004`
日常大数阅读	`"N0"`（无小数）	`1000000` → `1,000,000`
精确保留2位小数	`"F2"` 或 `"0.00"`	`3.14159` → `3.14`
转十六进制（大写）	`"X4"`	`255` → `00FF`
百分比显示	`"P2"`	`0.75` → `75.00%`