DateTimeFormatInfo.LongDatePattern Property
Gets or sets the custom format string for a long date value.
Namespace: System.Globalization
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.
using System; using System.Globalization; public class Example { public static void Main() { DateTime date1 = new DateTime(2001, 11, 12); string[] cultureNames = { "en-US", "fr-FR", "ru-RU", "de-DE" }; Console.WriteLine("{0,-7} {1,-20} {2:D}\n", "Culture", "Long Date Pattern", "Date"); foreach (var cultureName in cultureNames) { CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName); Console.WriteLine("{0,-7} {1,-20} {2}", culture.Name, culture.DateTimeFormat.LongDatePattern, date1.ToString("D", culture)); } } } // The example displays the following output: // Culture Long Date Pattern Date // en-US dddd, MMMM dd, yyyy Saturday, November 12, 2011 // fr-FR dddd d MMMM yyyy samedi 12 novembre 2011 // ru-RU d MMMM yyyy 'г.' 12 ноября 2011 г. // de-DE dddd, d. MMMM yyyy Samstag, 12. November 2011
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.
using System; using System.Globalization; using System.IO; public class Example { public static void Main() { DateTime date1 = new DateTime(2011, 8, 7); CultureInfo ci = CultureInfo.CreateSpecificCulture("ar-SY"); StreamWriter sw = new StreamWriter(@".\arSYCalendars.txt"); sw.WriteLine("{0,-32} {1,-21} {2}\n", "Calendar", "Long Date Pattern", "Example Date"); foreach (var cal in ci.OptionalCalendars) { ci.DateTimeFormat.Calendar = cal; sw.WriteLine("{0,-32} {1,-21} {2}", GetCalendarName(cal), ci.DateTimeFormat.LongDatePattern, date1.ToString("D", ci)); } sw.Close(); } private static string GetCalendarName(Calendar cal) { string calName; calName = cal.GetType().Name.Substring(0, cal.GetType().Name.IndexOf("Cal")); if (calName.Equals("Gregorian")) { GregorianCalendar grCal = cal as GregorianCalendar; calName += String.Format("-{0}", grCal.CalendarType); } return calName; } } // The example generates the following output: // Calendar Long Date Pattern Example Date // // Gregorian-Localized dd MMMM, yyyy 07 آب, 2011 // UmAlQura dd/MMMM/yyyy 07/رمضان/1432 // Hijri dd/MM/yyyy 08/09/1432 // Gregorian-USEnglish dddd, MMMM dd, yyyy Sunday, August 07, 2011 // Gregorian-MiddleEastFrench dddd, MMMM dd, yyyy dimanche, août 07, 2011 // Gregorian-TransliteratedEnglish dddd, MMMM dd, yyyy الأحد, أغسطس 07, 2011 // Gregorian-TransliteratedFrench dddd, MMMM dd, yyyy الأحد, أوت 07, 2011
The following example displays the value of the LongDatePattern property for a few cultures.
using System; using System.Globalization; public class SamplesDTFI { public static void Main() { // Displays the values of the pattern properties. Console.WriteLine( " CULTURE PROPERTY VALUE" ); PrintPattern( "en-US" ); PrintPattern( "ja-JP" ); PrintPattern( "fr-FR" ); } public static void PrintPattern( String myCulture ) { DateTimeFormatInfo myDTFI = new CultureInfo( myCulture, false ).DateTimeFormat; Console.WriteLine( " {0} {1}", myCulture, myDTFI.LongDatePattern ); } } /* 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 */
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
