DateTimeFormatInfo.LongDatePattern Propriété

Définition

Espace de noms:

System.Globalization

Assembly:

System.Runtime.dll

Source:

DateTimeFormatInfo.cs

Obtient ou définit la chaîne de format personnalisée pour une valeur de date longue.

C#

public string LongDatePattern { get; set; }

Valeur de propriété

String

Chaîne de format personnalisée pour une valeur de date longue.

Exceptions

ArgumentNullException

La propriété est définie sur null.

InvalidOperationException

La propriété est définie et l’objet DateTimeFormatInfo est en lecture seule.

Exemples

L’exemple suivant affiche la valeur de la LongDatePattern propriété pour quelques cultures.

C#

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:

 CULTURE    PROPERTY VALUE
  en-US     dddd, MMMM d, yyyy
  ja-JP     yyyy'年'M'月'd'日'
  fr-FR     dddd d MMMM yyyy

*/

Remarques

La LongDatePattern propriété définit le format spécifique à la culture des chaînes de dates qui sont retournées par des DateTime.ToString appels aux méthodes et DateTimeOffset.ToString et par des chaînes de format composite fournies par la chaîne de format standard « D ». L’exemple suivant illustre les relations entre les éléments suivants : la chaîne de format standard « D », la chaîne de format personnalisée retournée par la LongDatePattern propriété et la représentation spécifique à la culture d’une date.

C#

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      DateTime date1 = new DateTime(2011, 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 d, 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

Consultez Chaînes de format de date et d’heure personnalisées pour connaître les spécificateurs de format personnalisé qui peuvent être combinés pour construire des chaînes de format personnalisées telles que « dddd, jj MMMM aaaa ».

Vous devez définir le séparateur de date dans le modèle de date longue sur une chaîne exacte au lieu d’utiliser l’espace réservé séparateur de date. Par exemple, pour obtenir le modèle MM-JJ-aaaa, définissez le modèle de date long sur « MM-JJ-aaaa ».

La valeur de cette propriété peut changer si le calendrier utilisé par une culture change. Par instance, l’exemple suivant montre comment la LongDatePattern propriété d’un CultureInfo objet qui représente la culture arabe (Syrie) change lorsque l’objet Calendar utilisé par la culture change.

C#

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 MMMM, yyyy         08 رمضان, 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

S’applique à

Voir aussi

• Chaînes de format de date et d'heure standard
• Chaînes de format de date et d’heure personnalisées