DateTime.Now.ToString()
DateTime.Now.ToString()是 C# 中格式化当前系统时间 / 日期的核心用法，通过传入不同格式字符串，可灵活输出符合业务需求的日期时间格式（如日志命名、报告时间戳、界面显示等）。以下是完整用法拆解，包含基础语法、常用格式、自定义规则和注意事项：
一、核心语法
// 基础形式：无参数（默认格式，受系统区域设置影响） string defaultTime = DateTime.Now.ToString(); // 核心形式：指定格式字符串（推荐，可控性强） string customTime = DateTime.Now.ToString("格式字符串"); // 进阶：指定格式 + 区域（避免多语言环境格式错乱） string enTime = DateTime.Now.ToString("yyyy-MM-dd", System.Globalization.CultureInfo.InvariantCulture);二、常用预设格式（快速套用）
C# 提供了预设格式符，对应常用的标准化格式，无需手动拼接：
| 格式符 | 含义 | 示例（当前时间：2025-12-18 15:30:45.123） |
|---|---|---|
d | 短日期格式 | 2025/12/18（系统区域为中文） |
D | 长日期格式 | 2025 年 12 月 18 日 星期四 |
t | 短时间格式 | 15:30 |
T | 长时间格式 | 15:30:45 |
f | 完整日期 + 短时间 | 2025 年 12 月 18 日 星期四 15:30 |
F | 完整日期 + 长时间 | 2025 年 12 月 18 日 星期四 15:30:45 |
g | 常规日期 + 短时间 | 2025/12/18 15:30 |
G | 常规日期 + 长时间 | 2025/12/18 15:30:45 |
o | 可排序格式（ISO 8601） | 2025-12-18T15:30:45.1230000+08:00 |
s | 可排序字符串格式 | 2025-12-18T15:30:45 |
u | UTC 可排序格式 | 2025-12-18 07:30:45Z（UTC 时间） |
示例代码：
// 输出：2025年12月18日 星期四 Console.WriteLine(DateTime.Now.ToString("D")); // 输出：2025-12-18T15:30:45（日志/数据库常用） Console.WriteLine(DateTime.Now.ToString("s"));三、自定义格式（精准控制）
通过自定义格式符拼接，可实现任意格式（机器视觉 / 工业场景高频使用，如文件名、检测报告时间戳）：
| 自定义符 | 含义 | 示例 |
|---|---|---|
yyyy | 4 位年份 | 2025 |
MM | 2 位月份（补 0） | 12 |
dd | 2 位日期（补 0） | 18 |
HH | 24 小时制（补 0） | 15 |
hh | 12 小时制（补 0） | 03 |
mm | 分钟（补 0） | 30 |
ss | 秒（补 0） | 45 |
fff | 毫秒（3 位，补 0） | 123 |
tt | 上午 / 下午（中文） | 下午 |
: | 时间分隔符 | : |
/ | 日期分隔符 | / |
高频自定义示例（工业 / 视觉场景）：
// 1. 文件名格式（无特殊字符）：20251218_153045 string fileNameTime = DateTime.Now.ToString("yyyyMMdd_HHmmss"); // 2. 高精度时间戳（含毫秒）：2025-12-18 15:30:45.123 string highPrecision = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff"); // 3. 12小时制带上午/下午：2025-12-18 03:30:45 下午 string twelveHour = DateTime.Now.ToString("yyyy-MM-dd hh:mm:ss tt"); // 4. 仅年月：2025-12 string yearMonth = DateTime.Now.ToString("yyyy-MM");四、关键注意事项
区域适配：
- 直接使用
ToString("yyyy/MM/dd")时，/会被系统区域的日期分隔符替换（如中文是/，英文是-）； - 若需固定分隔符（如强制
-），用InvariantCulture：// 强制输出：2025-12-18（不受系统区域影响） string fixedFormat = DateTime.Now.ToString("yyyy-MM-dd", CultureInfo.InvariantCulture);
- 直接使用
大小写敏感：
MM是月份（01-12），mm是分钟；HH是 24 小时制，hh是 12 小时制；yyyy是 4 位年，yy是 2 位年（25）。
空格式 / 无参数：
DateTime.Now.ToString()等价于ToString("G")（常规格式），输出如2025/12/18 15:30:45（中文系统）；- 不推荐无参数使用，易因系统区域不同导致格式错乱。
UTC 时间：若需世界统一时间（而非本地时间），用
DateTime.UtcNow：// UTC时间：2025-12-18 07:30:45 string utcTime = DateTime.UtcNow.ToString("yyyy-MM-dd HH:mm:ss");
五、工业场景实战示例（机器视觉）
// 场景：视觉检测报告命名（含时间戳） string reportName = $"PMA检测报告_{DateTime.Now.ToString("yyyyMMdd_HHmmss_fff")}.pdf"; // 输出：PMA检测报告_20251218_153045_123.pdf // 场景：日志记录（精准时间） string log = $"[{DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss.fff")}] PMA工具XY位置：X=123.45, Y=67.89"; // 输出：[2025-12-18 15:30:45.123] PMA工具XY位置：X=123.45, Y=67.89visionPro脚本写入CSV方法
using System.Text; CogToolBlock block1 = (CogToolBlock) mToolBlock.Tools["四合一磁铁"]; CogToolBlock block2 = (CogToolBlock) mToolBlock.Tools["长方形磁铁"]; CogToolBlock block3 = (CogToolBlock) mToolBlock.Tools["细长磁铁"]; double percent1 = (double)block1.Outputs["percent1"].Value, percent2 = (double) block1.Outputs["percent2"].Value, percent3 = (double) block1.Outputs["percent3"].Value, percent4 = (double) block1.Outputs["percent4"].Value, percent5 = (double) block2.Outputs["percent5"].Value, percent6 = (double) block3.Outputs["percent6"].Value; mToolBlock.Outputs["FlowResult"].Value = (bool)block1.Outputs["FlowResult"].Value && (bool)block2.Outputs["FlowResult"].Value && (bool)block3.Outputs["FlowResult"].Value; // 调用方法写入数据 WriteCsvNew ( mToolBlock.Outputs["FlowResult"].Value.ToString() + "," + percent1.ToString("f2") + "," + percent2.ToString("f2") + "," + percent3.ToString("f2") + "," + percent4.ToString("f2") + "," + percent5.ToString("f2") + "," + percent6.ToString("f2") + "," ); // 写入CSV文件方法 void WriteCsvNew(string result) { // 路径 string path = "D:\\CCD数据\\"; // 文件名称 string fileName = path + DateTime.Now.ToString("yyyy-MM-dd-") + "窗口1" + ".csv"; // 此时时间 string Datedate = DateTime.Now.ToString("T"); if(!Directory.Exists(path)) { Directory.CreateDirectory(path); } if(!File.Exists(fileName)) { StreamWriter sw = new StreamWriter(fileName, true, Encoding.UTF8); // 表头 string str1 = "时间" + "," + "总结果" + "," + "四合一1" + "," + "四合一2" + "," + "四合一3" + "," + "四合一4" + "," + "长方形" + "," + "细长1" + "," + "\t\n"; sw.Write(str1); sw.Close(); } StreamWriter sw1 = new StreamWriter(fileName, true, Encoding.UTF8); // 内容拼接 string str = Datedate + "," + result + "\t\n"; sw1.Write(str); sw1.Close(); }
