如何实现不受服务器区域设置影响的C# DateTime格式化？

技术环境 #

• .NET 6
• C# 10
• Hasura GraphQL v2.6.2-pro.1
• Microsoft SQL Server 2019
• Visual Studio 2022
• "GraphQL" version="7.3.1" Proxy
• "GraphQL.Client" version="5.1.1" Proxy
• "GraphQL.Client.Serializer.Newtonsoft" version="5.1.1" Proxy

问题场景 #

我的代码需要完成Unix时间戳到日期字符串的转换：

1. 整数Unix时间戳转DateTimeOffset
2. DateTimeOffset转DateTime
3. DateTime转指定格式的字符串

原代码用"dd-MMM-yyyy hh:mm:ss tt"格式化时，触发SQL Server转换错误：

{"Errors (1)\r\n1: Data exception. Invalid datetime format.
[Microsoft][ODBC Driver 18 for SQL Server][SQL Server] The conversion
of a nvarchar data type to a datetime data type resulted in an
out-of-range value.\r\n"}

改成"yyyy-MM-dd HH:mm:ss.fff"后错误消失，但担心服务器区域设置变更后问题复发，想让格式化逻辑彻底不受区域影响。

解决方法 #

1. 用CultureInfo.InvariantCulture固定格式化规则 #

在ToString方法里传入CultureInfo.InvariantCulture，不管服务器区域怎么改，格式化出来的字符串格式都不会变：

using System.Globalization;

_DateCreated = DateTimeOffset
    .FromUnixTimeMilliseconds(emailEvent.TimeStamp)
    .DateTime
    .ToString("yyyy-MM-dd HH:mm:ss.fff", CultureInfo.InvariantCulture);

要是你需要用dd-MMM-yyyy这类带月份缩写的格式，同样可以结合不变文化，避免不同区域下月份缩写不一样的问题：

_DateCreated = DateTimeOffset
    .FromUnixTimeMilliseconds(emailEvent.TimeStamp)
    .DateTime
    .ToString("dd-MMM-yyyy hh:mm:ss tt", CultureInfo.InvariantCulture);

2. 优先用参数化查询（更稳妥） #

如果你的代码是把日期写入SQL Server，最靠谱的方式是跳过字符串转换，直接把DateTime/DateTimeOffset作为参数传给SQL命令：

// 示例：参数化插入SQL
var sqlCmd = new SqlCommand("INSERT INTO YourTable (DateCreated) VALUES (@DateCreated)", dbConnection);
sqlCmd.Parameters.Add("@DateCreated", SqlDbType.DateTime)
    .Value = DateTimeOffset.FromUnixTimeMilliseconds(emailEvent.TimeStamp).DateTime;
sqlCmd.ExecuteNonQuery();

这种方式完全避开了区域设置和字符串解析的坑，还能防止SQL注入。

原理说明 #

• CultureInfo.InvariantCulture是一个与区域无关的固定规则集，它的日期格式化逻辑不会随服务器区域配置改变，保证输出的字符串格式稳定一致。
• SQL Server解析日期字符串时会依赖数据库的默认语言/区域，直接传日期类型参数能彻底避免字符串解析带来的所有兼容问题。

内容的提问来源于stack exchange，提问作者crazyTech