DateTimeFormatInfo::LongDatePattern Property
Gets or sets the custom format string for a long date value.
Assembly: mscorlib (in mscorlib.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | The property is being set to null. |
| InvalidOperationException | The property is being set and the DateTimeFormatInfo object is read-only. |
The LongDatePattern property defines the culture-specific format of date strings that are returned by calls to the DateTime::ToString and DateTimeOffset::ToString methods and by composite format strings that are supplied the "D" standard format string. The following example illustrates the relationships among the following: the "D" standard format string, the custom format string returned by the LongDatePattern property, and the culture-specific representation of a date.
See Custom Date and Time Format Strings for individual custom format specifiers that can be combined to construct custom format strings such as "dddd, dd MMMM yyyy".
You should set the date separator in the long date pattern to an exact string instead of using the date separator placeholder. For example, to obtain the pattern MM-DD-yyyy, set the long date pattern to "MM-DD-yyyy".
The value of this property may change if the calendar used by a culture changes. For instance, the following example shows how theLongDatePattern property of a CultureInfo object that represents the Arabic (Syria) culture changes when the Calendar object used by the culture changes.
The following example displays the value of the LongDatePattern property for a few cultures.
using namespace System; using namespace System::Globalization; void PrintPattern( String^ myCulture ) { CultureInfo^ MyCI = gcnew CultureInfo( myCulture,false ); DateTimeFormatInfo^ myDTFI = MyCI->DateTimeFormat; Console::WriteLine( " {0} {1}", myCulture, myDTFI->LongDatePattern ); } int main() { // Displays the values of the pattern properties. Console::WriteLine( " CULTURE PROPERTY VALUE" ); PrintPattern( "en-US" ); PrintPattern( "ja-JP" ); PrintPattern( "fr-FR" ); } /* This code produces the following output. The question marks take the place of native script characters. CULTURE PROPERTY VALUE en-US dddd, MMMM dd, yyyy ja-JP yyyy'?'M'?'d'?' fr-FR dddd d MMMM yyyy */
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1