System.TimeZoneInfo.FindSystemTimeZoneById(String id) should be better documented.

[BieleckiLtd]

Honestly, I wish this method did not exist at all as it would have encouraged me to look up 3rd party libraries like https://github.com/mattjohnsonpint/TimeZoneConverter right away. Instead, I spent hours debugging why it was functional on my computer (Windows 10) but not on the server (Windows Server). The function's dependency on the operating system should be explicitly mentioned in the XML comments.

Tagging subscribers to this area: @dotnet/area-system-datetime
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Honestly, I wish this method did not exist at all as it would have encouraged me to look up 3rd party libraries like https://github.com/mattjohnsonpint/TimeZoneConverter right away. Instead, I spent hours debugging why it was functional on my computer (Windows 10) but not on the server (Windows Server). The function's dependency on the operating system should be explicitly mentioned in the XML comments.

Author:	BieleckiLtd
Assignees:	-
Labels:	untriaged, area-System.DateTime
Milestone:	-

[tarekgh]

@BieleckiLtd what exactly was not working on the server? What version of .NET are you using?

This issue has been marked needs-author-action and may be missing some important information.

[BieleckiLtd]

@BieleckiLtd what exactly was not working on the server? What version of .NET are you using?

This below exception for instance was not thrown on my dev computer. I'm publishing as a self-contained deployment to avoid any .NET versioning differences. I'm using .NET 7.0

System.TimeZoneNotFoundException: The time zone ID 'Europe/Berlin' was not found on the local computer.
   at System.TimeZoneInfo.FindSystemTimeZoneById(String id)

[tarekgh]

What is the version of the server you are running on which fails there?