用途:为 .NET 与 C# 代码中的时区问题提供生产级建议与可复制代码片段,覆盖地址/地点查询、时区 ID 查询、UTC 与本地时间转换、跨平台兼容、调度与夏令时处理、API 与持久化设计等场景。
主要能力:先识别请求类型;若库不明确,跨平台工作默认推荐 TimeZoneConverter,涉及重复调度或严格夏令时规则时优先 NodaTime。对地址、城市、地区、国家或含地名的文档,提取每个地点,查阅 references/timezone-index.md 中的 Windows 与 IANA 常见映射;未列出时按地理推断 IANA 区再映射到 Windows ID,并返回两种 ID、UTC 偏移、是否有夏令时及可用 C# 示例。时区 ID 查询始终同时给出 Windows ID(供 Windows 上 TimeZoneInfo.FindSystemTimeZoneById() 使用)与 IANA ID(供 Linux、容器、NodaTime、TimeZoneConverter 使用)。
使用方式:按 references/code-patterns.md 选择最小合适模式,包括仅 Windows 的 TimeZoneInfo、跨平台的 TimeZoneConverter、严格时区运算与夏令时调度的 NodaTime、用于 API 与数据传输的 DateTimeOffset、ASP.NET Core 持久化与展示、重复任务与调度器、以及歧义或无效夏令时时间戳。推荐第三方库时附带包指引。示例:using TimeZoneConverter; TimeZoneInfo tz = TZConvert.GetTimeZoneInfo("Asia/Colombo"); DateTime local = TimeZoneInfo.ConvertTimeFromUtc(DateTime.UtcNow, tz);
限制与注意:TimeZoneInfo.FindSystemTimeZoneById() 的时区 ID 具有平台特定性;避免在数据库存储 DateTime.Now,应存 UTC;除非是刻意输入,DateTimeKind.Unspecified 视为缺陷风险;夏令时切换可能跳过或重复本地时间;Azure Windows 与 Azure Linux 可能期望不同的时区 ID 格式。地点有歧义时列出可能匹配并请用户确认。回复保持简洁、代码优先。其他细节暂未提供。