Dotnet Timezone

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

Always include package guidance when recommending third-party libraries.

Warn About Common Pitfalls

Mention the relevant warning when applicable:

• TimeZoneInfo.FindSystemTimeZoneById() is platform-specific for timezone IDs.
• Avoid storing DateTime.Now in databases; store UTC instead.
• Treat DateTimeKind.Unspecified as a bug risk unless it is deliberate input.
• DST transitions can skip or repeat local times.
• Azure Windows and Azure Linux environments may expect different timezone ID formats.

Response Shape

For address and location requests:

1. Return the resolved timezone block for each location.
2. State the recommended implementation in one sentence.
3. Include a copy-paste-ready C# snippet.

For code and architecture requests:

1. State the recommended approach in one sentence.
2. Provide the timezone IDs if relevant.
3. Include the minimal working code snippet.
4. Mention the package requirement if needed.
5. Add one pitfall warning if it matters.

Keep responses concise and code-first.

References

• references/timezone-index.md: common Windows and IANA timezone mappings
• references/code-patterns.md: ready-to-use .NET timezone patterns