dotnet-timezone

.NET Timezone

Resolve timezone questions for .NET and C# code with production-safe guidance and copy-paste-ready snippets.

Start With The Right Path

Identify the request type first:

• Address or location lookup
• Timezone ID lookup
• UTC/local conversion
• Cross-platform timezone compatibility
• Scheduling or DST handling
• API or persistence design

If the library is unclear, default to TimeZoneConverter for cross-platform work. If the scenario involves recurring schedules or strict DST rules, prefer NodaTime.

Resolve Addresses And Locations

If the user provides an address, city, region, country, or document containing place names:

1. Extract each location from the input.
2. Read references/timezone-index.md for common Windows and IANA mappings.
3. If the exact location is not listed, infer the correct IANA zone from geography, then map it to the Windows ID.
4. Return both IDs and a ready-to-use C# example.

For each resolved location, provide:

Location: <resolved place>
Windows ID: <windows id>
IANA ID: <iana id>
UTC offset: <standard offset and DST offset when relevant>
DST: <yes/no>

Then include a cross-platform snippet like:

using TimeZoneConverter;

TimeZoneInfo tz = TZConvert.GetTimeZoneInfo("Asia/Colombo");
DateTime local = TimeZoneInfo.ConvertTimeFromUtc(DateTime.UtcNow, tz);

If multiple locations are present, include one block per location and then a combined multi-timezone snippet.

If a location is ambiguous, list the possible timezone matches and ask the user to choose the correct one.

Look Up Timezone IDs

Use references/timezone-index.md for Windows to IANA mappings.

Always provide both formats:

• Windows ID for TimeZoneInfo.FindSystemTimeZoneById() on Windows
• IANA ID for Linux, containers, NodaTime, and TimeZoneConverter

Generate Code

Use references/code-patterns.md and pick the smallest pattern that fits:

• Pattern 1: TimeZoneInfo for Windows-only code
• Pattern 2: TimeZoneConverter for cross-platform conversion
• Pattern 3: NodaTime for strict timezone arithmetic and DST-sensitive scheduling
• Pattern 4: DateTimeOffset for APIs and data transfer
• Pattern 5: ASP.NET Core persistence and presentation
• Pattern 6: recurring jobs and schedulers
• Pattern 7: ambiguous and invalid DST timestamps