如何根据用户存储设置修改Azure App Service的显示时区？

核心结论 #

WEBSITE_TIME_ZONE是Azure Web App的全局配置参数，修改它会影响整个应用的所有用户，无法实现单个用户的动态时区调整。因此你需要从应用层入手，而非修改这个全局配置。

实现步骤 #

1. 存储用户时区选择 #

在用户设置表中保存用户选择的IANA时区标识符（例如Asia/Shanghai、America/New_York），不要存储固定的时区偏移量——因为夏令时会导致偏移量变化，标识符能自动适配这类规则。

2. 登录后加载用户时区 #

用户登录成功后，从数据库取出该用户的时区值，将其存储到用户会话（Session）中；如果是无状态认证（比如JWT），可以把时区标识符嵌入到令牌的Claims里，确保每次请求都能获取到当前用户的时区信息。

3. 应用层处理时区转换 #

后端处理（推荐统一用UTC存储）

• 数据库中所有日期时间字段统一存储为UTC时间，避免时区混乱。
• 当需要向用户展示时间时，根据用户的时区标识符，将UTC时间转换为用户时区的本地时间。

示例代码（.NET）：

// 从会话获取用户时区ID
var userTimeZoneId = HttpContext.Session.GetString("UserTimeZone");
if (!string.IsNullOrEmpty(userTimeZoneId))
{
    var targetTimeZone = TimeZoneInfo.FindSystemTimeZoneById(userTimeZoneId);
    // 从数据库读取的UTC时间
    DateTime utcTime = DateTime.SpecifyKind(dbEntity.CreatedTime, DateTimeKind.Utc);
    // 转换为用户时区时间
    DateTime userLocalTime = TimeZoneInfo.ConvertTimeFromUtc(utcTime, targetTimeZone);
    // 返回给前端使用
}

前端处理

如果是单页应用，可以在前端拿到用户时区后，直接用浏览器的API转换UTC时间：

// 假设后端返回用户时区和UTC时间字符串
const userTimeZone = "Asia/Shanghai";
const utcDate = new Date("2024-05-20T14:30:00Z");
// 配置格式化选项
const formatOptions = { 
    timeZone: userTimeZone,
    year: 'numeric', month: 'short', day: 'numeric',
    hour: '2-digit', minute: '2-digit'
};
// 生成用户时区的时间字符串
const localTimeStr = new Intl.DateTimeFormat('zh-CN', formatOptions).format(utcDate);

关键注意事项 #

• 永远用UTC时间存储到数据库，这是避免时区问题的核心原则。
• 优先使用IANA时区标识符，而非Windows时区ID，兼容性更强（跨平台场景更友好）。
• 不要依赖服务器的本地时区，所有时间处理都基于UTC进行转换。

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