菜鸟的C#学习（四）

一、格式说明符

C# 中的格式说明符用于格式化各种数据类型的字符串表示，主要分为以下几类，按数据类型分类列举并提供组合示例：

1.1、数字格式说明符（适用于数值类型：int, double, decimal 等）

1. 标准数字格式

• C/c：货币格式（自动添加货币符号，受当前文化影响）

  Console.WriteLine($"{1234.56:C}");  // ￥1,234.56（中文环境）
  

• D/d：十进制整数格式（指定位数时不足补0）

  Console.WriteLine($"{123:D5}");     // 00123（固定5位）
  

• E/e：科学计数法（E为大写，e为小写）

  Console.WriteLine($"{1234.56:E3}"); // 1.235E+003（保留3位小数）
  

• F/f：固定小数位格式

  Console.WriteLine($"{1234.567:F2}"); // 1234.57（保留2位小数）
  

• G/g：通用格式（自动选择最简洁的表示）

  Console.WriteLine($"{1234.567:G4}"); // 1235（总位数4位，四舍五入）
  

• N/n：带千分位分隔符的数字

  Console.WriteLine($"{1234567:N2}"); // 1,234,567.00
  

• P/p：百分比格式（数值乘以100并加%）

  Console.WriteLine($"{0.123:P1}");   // 12.3%（保留1位小数）
  

• X/x：十六进制格式（X大写，x小写）

  Console.WriteLine($"{255:X2}");     // FF（2位大写）
  Console.WriteLine($"{255:x4}");     // 00ff（4位小写）
  

2. 自定义数字格式

• 0：占位符（位数不足补0，超出则原样显示）
• #：占位符（位数不足不补0，超出则原样显示）
• .：小数点
• ,：千分位分隔符（可重复表示比例缩放，如 ,, 表示除以100万）
• %：百分比（数值乘以100）
• \：转义字符（显示特殊符号）

示例：

// 整数部分至少3位，小数部分固定2位
Console.WriteLine($"{12.3:000.00}");   // 012.30// 整数部分可选，小数部分最多2位（不补0）
Console.WriteLine($"{1234.567:###.##}"); // 1234.57// 千分位分隔+比例缩放（除以1000，显示为"千"）
Console.WriteLine($"{1234567:###,}k");   // 1235k（四舍五入到千位）// 混合百分比和自定义格式
Console.WriteLine($"{0.1234:00.0%}");    // 12.3%

1.2、日期时间格式说明符（适用于 DateTime, DateTimeOffset）

1. 标准日期时间格式

• d：短日期（如 2023/10/05）
• D：长日期（如 2023年10月5日）
• t：短时间（如 14:30）
• T：长时间（如 14:30:45）
• f：完整日期+短时间（如 2023年10月5日 14:30）
• F：完整日期+长时间（如 2023年10月5日 14:30:45）
• g：常规日期+短时间（如 2023/10/05 14:30）
• G：常规日期+长时间（如 2023/10/05 14:30:45）
• s：可排序日期时间（如 2023-10-05T14:30:45，ISO 8601）
• u：UTC可排序时间（如 2023-10-05 14:30:45Z）

示例：

DateTime dt = new DateTime(2023, 10, 5, 14, 30, 45);
Console.WriteLine($"{dt:d}"); // 10/5/2023
Console.WriteLine($"{dt:G}"); // 10/5/2023 14:30:45

2. 自定义日期时间格式

• y/yy/yyy/yyyy：年（如 23/2023）
• M/MM：月（1-12/01-12）
• d/dd：日（1-31/01-31）
• h/hh：12小时制时（1-12/01-12）
• H/HH：24小时制时（0-23/00-23）
• m/mm：分（0-59/00-59）
• s/ss：秒（0-59/00-59）
• f/ff/fff：毫秒（1位/2位/3位）
• t：上午/下午（A/P）
• z/zz/zzz：时区偏移（如 +08/+08:00）

示例：

DateTime dt = new DateTime(2023, 10, 5, 14, 30, 45, 123);
// 格式：年-月-日 时:分:秒.毫秒 时区
Console.WriteLine($"{dt:yyyy-MM-dd HH:mm:ss.fff zzz}"); 
// 输出：2023-10-05 14:30:45.123 +08:00

1.3、枚举格式说明符（适用于 enum 类型）

• G/g：默认（显示枚举名， Flags 组合时用逗号分隔）
• F/f：Flags 组合时强制显示所有名称（即使未标记 Flags）
• D/d：显示枚举的基础数值
• X/x：显示基础数值的十六进制形式

示例：

[Flags]
enum MyEnum { A = 1, B = 2, C = 4 }
MyEnum val = MyEnum.A | MyEnum.C;Console.WriteLine($"{val:G}"); // A, C（名称组合）
Console.WriteLine($"{val:D}"); // 5（基础数值）
Console.WriteLine($"{val:X}"); // 00000005（十六进制）

1.4、组合格式示例

1. 数字+日期组合：

var data = new { Amount = 1234.56, Date = new DateTime(2023, 10, 5) };
Console.WriteLine($"{data.Date:yyyy-MM-dd} 交易金额：{data.Amount:C2}");
// 输出：2023-10-05 交易金额：￥1,234.56

2. 自定义数字+转义字符：

double ratio = 0.7532;
Console.WriteLine($"完成率：{ratio:00.00%}（{ratio:0.##}）");
// 输出：完成率：75.32%（0.75）

3. 时间+毫秒精度：

DateTime dt = DateTime.Now;
Console.WriteLine($"当前时间：{dt:HH:mm:ss.fff}");
// 输出：当前时间：15:42:36.789

说明

• 格式说明符区分大小写（如 X 和 x 分别对应大小写十六进制）。
• 可通过 IFormatProvider 自定义文化（如指定 CultureInfo.InvariantCulture 避免地区差异）。
• 组合使用时，多个格式说明符需按类型规则拆分（如数字和日期需分别指定格式）。

二、

三、

四、