Use overloads to avoid breaking change from 5.x (#129)

Author: mattjohnsonpint

src/TimeZoneConverter/TZConvert.cs

@@ -82,7 +82,7 @@ public static IReadOnlyDictionary<string, IReadOnlyCollection<string>> GetIanaTi
                         .OrderBy(zone => zone)
                         .ToList().AsReadOnly()));
         }
-        
+
         // Converting to windows and back has the reduction effect we are looking for
         return new ReadOnlyDictionary<string, IReadOnlyCollection<string>>(
             IanaTerritoryZones.ToDictionary(
@@ -127,6 +127,24 @@ public static bool TryIanaToWindows(string ianaTimeZoneName, [MaybeNullWhen(fals
         return IanaMap.TryGetValue(ianaTimeZoneName, out windowsTimeZoneId!);
     }
 
+    /// <summary>
+    /// Converts a Windows time zone ID to an equivalent IANA time zone name.
+    /// </summary>
+    /// <param name="windowsTimeZoneId">The Windows time zone ID to convert.</param>
+    /// <param name="territoryCode">
+    /// An optional two-letter ISO Country/Region code, used to get a a specific mapping.
+    /// Defaults to "001" if not specified, which means to get the "golden zone" - the one that is most prevalent.
+    /// </param>
+    /// <returns>An IANA time zone name.</returns>
+    /// <exception cref="InvalidTimeZoneException">
+    /// Thrown if the input string was not recognized or has no equivalent IANA
+    /// zone.
+    /// </exception>
+    public static string WindowsToIana(string windowsTimeZoneId, string territoryCode = "001")
+    {
+        return WindowsToIana(windowsTimeZoneId, territoryCode, LinkResolution.Default);
+    }
+
     /// <summary>
     /// Converts a Windows time zone ID to an equivalent IANA time zone name.
     /// </summary>
@@ -156,10 +174,7 @@ public static string WindowsToIana(string windowsTimeZoneId, LinkResolution link
     /// Thrown if the input string was not recognized or has no equivalent IANA
     /// zone.
     /// </exception>
-    public static string WindowsToIana(
-        string windowsTimeZoneId,
-        string territoryCode = "001",
-        LinkResolution linkResolutionMode = LinkResolution.Default)
+    public static string WindowsToIana(string windowsTimeZoneId, string territoryCode, LinkResolution linkResolutionMode)
     {
         if (TryWindowsToIana(windowsTimeZoneId, territoryCode, out var ianaTimeZoneName, linkResolutionMode))
         {
@@ -169,6 +184,20 @@ public static string WindowsToIana(
         throw new InvalidTimeZoneException(
             $"\"{windowsTimeZoneId}\" was not recognized as a valid Windows time zone ID.");
     }
+    
+    /// <summary>
+    /// Attempts to convert a Windows time zone ID to an equivalent IANA time zone name.
+    /// Uses the "golden zone" - the one that is the most prevalent.
+    /// </summary>
+    /// <param name="windowsTimeZoneId">The Windows time zone ID to convert.</param>
+    /// <param name="ianaTimeZoneName">An IANA time zone name.</param>
+    /// <returns><c>true</c> if successful, <c>false</c> otherwise.</returns>
+    public static bool TryWindowsToIana(
+        string windowsTimeZoneId,
+        [MaybeNullWhen(false)] out string ianaTimeZoneName)
+    {
+        return TryWindowsToIana(windowsTimeZoneId, "001", out ianaTimeZoneName, LinkResolution.Default);
+    }
 
     /// <summary>
     /// Attempts to convert a Windows time zone ID to an equivalent IANA time zone name.
@@ -181,11 +210,29 @@ public static string WindowsToIana(
     public static bool TryWindowsToIana(
         string windowsTimeZoneId,
         [MaybeNullWhen(false)] out string ianaTimeZoneName,
-        LinkResolution linkResolutionMode = LinkResolution.Default)
+        LinkResolution linkResolutionMode)
     {
         return TryWindowsToIana(windowsTimeZoneId, "001", out ianaTimeZoneName, linkResolutionMode);
     }
 
+    /// <summary>
+    /// Attempts to convert a Windows time zone ID to an equivalent IANA time zone name.
+    /// </summary>
+    /// <param name="windowsTimeZoneId">The Windows time zone ID to convert.</param>
+    /// <param name="territoryCode">
+    /// An optional two-letter ISO Country/Region code, used to get a a specific mapping.
+    /// Defaults to "001" if not specified, which means to get the "golden zone" - the one that is most prevalent.
+    /// </param>
+    /// <param name="ianaTimeZoneName">An IANA time zone name.</param>
+    /// <returns><c>true</c> if successful, <c>false</c> otherwise.</returns>
+    public static bool TryWindowsToIana(
+        string windowsTimeZoneId,
+        string territoryCode,
+        [MaybeNullWhen(false)] out string ianaTimeZoneName)
+    {
+        return TryWindowsToIana(windowsTimeZoneId, territoryCode, out ianaTimeZoneName, LinkResolution.Default);
+    }
+
     /// <summary>
     /// Attempts to convert a Windows time zone ID to an equivalent IANA time zone name.
     /// </summary>
@@ -201,7 +248,7 @@ public static bool TryWindowsToIana(
         string windowsTimeZoneId,
         string territoryCode,
         [MaybeNullWhen(false)] out string ianaTimeZoneName,
-        LinkResolution linkResolutionMode = LinkResolution.Default)
+        LinkResolution linkResolutionMode)
     {
         // try first with the given region
         var found = WindowsMap.TryGetValue($"{territoryCode}|{windowsTimeZoneId}", out var ianaId);

src/TimeZoneConverter/TimeZoneConverter.csproj

@@ -8,7 +8,7 @@
     <PackageTags>timezone;time;zone;time zone;iana;tzdb;olson;timezoneinfo,rails</PackageTags>
     <PackageProjectUrl>https://github.com/mattjohnsonpint/TimeZoneConverter</PackageProjectUrl>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
-    <Version>6.0.0</Version>
+    <Version>6.0.1</Version>
   </PropertyGroup>
 
   <ItemGroup>