如何管理全球化.NET应用的DateTime时间转换与存储？

一、用户提交时间：本地转UTC的环节选择 #

推荐方案1：前端直接转UTC后提交 #

• 前端用JavaScript的new Date().toISOString()方法，把用户输入的本地时间转成带Z后缀的UTC格式字符串（比如2024-05-20T14:30:00Z）
• Web API接收到字符串后，直接解析为DateTime（指定DateTimeKind.Utc）或DateTimeOffset类型，无需额外转换，直接存入数据库
• 优势：前端自己处理时区，API逻辑更简洁，避免后端处理时区信息时出错

推荐方案2：前端提交带时区的本地时间，API层转UTC #

• 前端提交包含时区信息的时间数据（比如用new Date().getTimezoneOffset()获取偏移量，或直接传DateTimeOffset格式字符串）
• Web API接收后，用.NET的DateTimeOffset.ToUniversalTime()方法转成UTC时间，再存入数据库
• 适用场景：需要保留用户原始时区信息做后续分析的情况

注意：绝对别在数据库层转——数据库没法准确获取用户本地时区，强行转换会导致时间偏差或丢失时区上下文。

二、前端展示时间：UTC转本地的环节选择 #

• Web API从数据库读取UTC时间后，直接以ISO 8601格式的UTC字符串返回给前端（比如2024-05-20T14:30:00Z）
• 前端接收到字符串后，用new Date(utcString)创建Date对象，浏览器会自动根据用户系统的时区设置，把UTC时间转成用户本地时间展示
• 要是需要自定义展示格式（比如YYYY-MM-DD HH:mm），可以用JavaScript的toLocaleString()方法，结合用户的语言和时区偏好做格式化

.NET开发关键注意事项 #

• 实体类优先用DateTimeOffset存时间，别用DateTime——DateTimeOffset自带时区偏移信息，能彻底避免DateTimeKind的歧义问题
• 数据库字段选UTC兼容类型：比如SQL Server用datetime2，PostgreSQL用timestamp with time zone
• Web API配置里，确保JSON序列化时把时间输出成ISO 8601格式的UTC字符串（.NET Core默认配置已支持，不用额外修改）

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