Merge pull request #7322 from dotnet/timheuer-dtparsepatch

tarekgh · web-flow · commit 52031fa687c9 · 2025-03-24T16:09:25.000-07:00
Update StringToParse section
diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml
@@ -5606,7 +5606,7 @@ juillet 2009
 
 <a name="StringToParse"></a>
 ### The string to parse
- The <xref:System.DateTime.Parse%2A> method tries to convert the string representation of a date and time value to its <xref:System.DateTime> equivalent. It tries to parse the input string completely without throwing a <xref:System.FormatException> exception.
+ The <xref:System.DateTime.Parse%2A> method tries to convert the string representation of a date and time value to its <xref:System.DateTime> equivalent. It tries to parse the input string completely without throwing a <xref:System.FormatException> exception. When using overloads that accept an <xref:System.IFormatProvider> object, it will be used to parse `StringToParse`. If no such object is provided, <xref:System.Globalization.CultureInfo.CurrentCulture> will be used instead.
 
 > [!IMPORTANT]
 >  If the parsing operation fails because of an unrecognized string format, the <xref:System.DateTime.Parse%2A> method throws a <xref:System.FormatException>, whereas the <xref:System.DateTime.TryParse%2A> method returns `false`. Because exception handling can be expensive, you should use <xref:System.DateTime.Parse%2A> when the parsing operation is expected to succeed because the input source is trusted. <xref:System.DateTime.TryParse%2A> is preferable when parsing failures are likely, particularly because an input source is not trusted, or you have reasonable default values to substitute for strings that do not parse successfully.
