From 0ea9698d3a4307cd8a831434bf3ff0f727994537 Mon Sep 17 00:00:00 2001
From: Henrique Feliciano de Azevedo <hfazevedo@furb.br>
Date: Wed, 25 Jun 2025 17:25:45 -0300
Subject: [PATCH 1/2] Add missing ArgumentException and FormatException
 documentation to DateTime.TryParseExact

---
 xml/System/DateTime.xml | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml
index 699302793be..37c888ff29b 100644
--- a/xml/System/DateTime.xml
+++ b/xml/System/DateTime.xml
@@ -9934,6 +9934,17 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
         <returns>
           <see langword="true" /> if <paramref name="s" /> was converted successfully; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
+
+ -or-
+
+ <paramref name="format" /> does not contain a valid custom format pattern.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
+
+ -or-
+
+ <paramref name="style" /> contains an invalid combination of <see cref="T:System.Globalization.DateTimeStyles" /> values (for example, both <see cref="F:System.Globalization.DateTimeStyles.AssumeLocal" /> and <see cref="F:System.Globalization.DateTimeStyles.AssumeUniversal" />).</exception>
       </Docs>
     </Member>
     <Member MemberName="TryParseExact">
@@ -9999,8 +10010,19 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
         <param name="result">When this method returns, contains the <see cref="T:System.DateTime" /> value equivalent to the date and time contained in <paramref name="s" />, if the conversion succeeded, or <see cref="F:System.DateTime.MinValue">DateTime.MinValue</see> if the conversion failed. The conversion fails if the <paramref name="s" /> parameter is <see langword="null" />, is <see cref="F:System.String.Empty" />, or does not contain a valid string representation of a date and time. This parameter is passed uninitialized.</param>
         <summary>Converts the specified char span of a date and time to its <see cref="T:System.DateTime" /> equivalent and returns a value that indicates whether the conversion succeeded.</summary>
         <returns>
-          <see langword="true" /> if the <paramref name="s" /> parameter was converted successfully; otherwise, <see langword="false" />.</returns>
+          <see langword="true" /> if <paramref name="s" /> was converted successfully; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
+
+ -or-
+
+ <paramref name="format" /> does not contain a valid custom format pattern.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
+
+ -or-
+
+ <paramref name="style" /> contains an invalid combination of <see cref="T:System.Globalization.DateTimeStyles" /> values (for example, both <see cref="F:System.Globalization.DateTimeStyles.AssumeLocal" /> and <see cref="F:System.Globalization.DateTimeStyles.AssumeUniversal" />).</exception>
       </Docs>
     </Member>
     <Member MemberName="TryParseExact">
@@ -10129,6 +10151,11 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
 
  ]]></format>
         </remarks>
+        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
+
+ -or-
+
+ <paramref name="format" /> does not contain a valid custom format pattern.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
 
@@ -10269,6 +10296,11 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
 
  ]]></format>
         </remarks>
+        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
+
+ -or-
+
+ <paramref name="format" /> does not contain a valid custom format pattern.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
 

From d72e7209beb50e82a0886bb22db9170cf5d7b4cb Mon Sep 17 00:00:00 2001
From: Henrique Feliciano de Azevedo <hfazevedo@furb.br>
Date: Wed, 25 Jun 2025 17:47:32 -0300
Subject: [PATCH 2/2] Fix incorrect exception text for DateTime.TryParseExact
 format arrays

---
 xml/System/DateTime.xml | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml
index 37c888ff29b..c12af809ab0 100644
--- a/xml/System/DateTime.xml
+++ b/xml/System/DateTime.xml
@@ -10012,11 +10012,7 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
         <returns>
           <see langword="true" /> if <paramref name="s" /> was converted successfully; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
-
- -or-
-
- <paramref name="format" /> does not contain a valid custom format pattern.</exception>
+        <exception cref="T:System.FormatException">The length of an element in <paramref name="formats" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.
 
@@ -10296,11 +10292,7 @@ The following example illustrates the <xref:System.DateTime.TryParse%28System.St
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.FormatException">The length of <paramref name="format" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.
-
- -or-
-
- <paramref name="format" /> does not contain a valid custom format pattern.</exception>
+        <exception cref="T:System.FormatException">The length of an element in <paramref name="formats" /> is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="style" /> is not a valid <see cref="T:System.Globalization.DateTimeStyles" /> value.