DateTime.ToString Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Convertit la valeur de l'objet DateTime actif en sa représentation équivalente sous forme de chaîne.

Surcharges

ToString(IFormatProvider)	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l'aide des informations de format propres à la culture spécifiées.
ToString(String)	Convertit la valeur de l’objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié et des conventions de mise en forme de la culture actuelle.
ToString()	Convertit la valeur de l’objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l’aide des conventions de mise en forme de la culture actuelle.
ToString(String, IFormatProvider)	Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de format spécifiques à la culture spécifiés.

ToString(IFormatProvider)

Source:

DateTime.cs

Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l'aide des informations de format propres à la culture spécifiées.

C#

public string ToString (IFormatProvider? provider);

Paramètres

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de la valeur de l'objet DateTime actuel tel que spécifié par provider.

Implémente

ToString(IFormatProvider)

Exceptions

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par provider.

Exemples

L’exemple suivant montre comment afficher la représentation sous forme de chaîne d’une date et d’une heure à l’aide CultureInfo d’objets qui représentent cinq cultures différentes.

C#

using System;
using System.Globalization;

public class ToStringExample3
{
   public static void Main2()
   {
      CultureInfo[] cultures = new CultureInfo[] {CultureInfo.InvariantCulture,
                                                  new CultureInfo("en-us"),
                                                  new CultureInfo("fr-fr"),
                                                  new CultureInfo("de-DE"),
                                                  new CultureInfo("es-ES"),
                                                  new CultureInfo("ja-JP")};

      DateTime thisDate = new DateTime(2009, 5, 1, 9, 0, 0);

      foreach (CultureInfo culture in cultures)
      {
         string cultureName;
         if (string.IsNullOrEmpty(culture.Name))
            cultureName = culture.NativeName;
         else
            cultureName = culture.Name;

         Console.WriteLine("In {0}, {1}",
                           cultureName, thisDate.ToString(culture));
      }
      }
}
// The example produces the following output:
//    In Invariant Language (Invariant Country), 05/01/2009 09:00:00
//    In en-US, 5/1/2009 9:00:00 AM
//    In fr-FR, 01/05/2009 09:00:00
//    In de-DE, 01.05.2009 09:00:00
//    In es-ES, 01/05/2009 9:00:00
//    In ja-JP, 2009/05/01 9:00:00

Remarques

La valeur de l’objet actuel DateTime est mise en forme à l’aide du spécificateur de format de date et d’heure général (« G »), qui met en forme la sortie à l’aide du modèle de date courte et du modèle d’heure long.

Le format du modèle de date courte et d’heure longue est défini par le provider paramètre . Le provider paramètre peut être l’un des éléments suivants :

• Objet CultureInfo qui représente la culture dont les conventions de mise en forme doivent être reflétées dans la chaîne retournée. L’objet DateTimeFormatInfo retourné par la CultureInfo.DateTimeFormat propriété définit la mise en forme de la chaîne retournée.

• Objet DateTimeFormatInfo qui définit le format des données de date et d’heure.

• Objet personnalisé qui implémente l’interface IFormatProvider . Sa GetFormat méthode retourne un DateTimeFormatInfo objet qui fournit des informations de mise en forme.

Si provider a la valeur null, l’objet DateTimeFormatInfo associé à la culture actuelle est utilisé. Pour plus d'informations, consultez CultureInfo.CurrentCulture.

Notes pour les appelants

La ToString(IFormatProvider) méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par la culture représentée par le provider paramètre . Son calendrier est défini par la Calendar propriété . Si la valeur de l’instance actuelle DateTime est antérieure MinSupportedDateTime ou ultérieure à MaxSupportedDateTime, la méthode lève un ArgumentOutOfRangeException. L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui se trouve en dehors de la plage de la JapaneseCalendar classe .

C#

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo jaJP = new CultureInfo("ja-JP");
      jaJP.DateTimeFormat.Calendar = new JapaneseCalendar();
      DateTime date1 = new DateTime(1867, 1, 1);

      try {
         Console.WriteLine(date1.ToString(jaJP));
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("{0:d} is earlier than {1:d} or later than {2:d}",
                           date1,
                           jaJP.DateTimeFormat.Calendar.MinSupportedDateTime,
                           jaJP.DateTimeFormat.Calendar.MaxSupportedDateTime);
      }
   }
}
// The example displays the following output:
//    1/1/1867 is earlier than 9/8/1868 or later than 12/31/9999   }

Voir aussi

• DateTimeFormatInfo
• CultureInfo

ToString(String)

Source:

DateTime.cs

Convertit la valeur de l’objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié et des conventions de mise en forme de la culture actuelle.

C#

public string ToString (string? format);

Paramètres

format

String

Chaîne de format de date et d'heure standard ou personnalisée.

Retours

String

Représentation sous forme de chaîne de la valeur de l'objet DateTime actuel tel que spécifié par format.

Exceptions

FormatException

La longueur de format est 1, et ce n’est pas l’un des caractères spécificateurs de format définis pour DateTimeFormatInfo.

- ou -

format ne contient pas un modèle de format personnalisé valide.

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par la culture actuelle.

Exemples

L’exemple suivant utilise chacune des chaînes de format de date et d’heure standard et une sélection de chaînes de format de date et d’heure personnalisées pour afficher la représentation sous forme de chaîne d’une DateTime valeur. La culture actuelle du thread pour l’exemple est en-US.

C#

using System;

public class DateToStringExample2
{
   public static void Main()
   {
      DateTime dateValue = new DateTime(2008, 6, 15, 21, 15, 07);
      // Create an array of standard format strings.
      string[] standardFmts = {"d", "D", "f", "F", "g", "G", "m", "o",
                               "R", "s", "t", "T", "u", "U", "y"};
      // Output date and time using each standard format string.
      foreach (string standardFmt in standardFmts)
         Console.WriteLine("{0}: {1}", standardFmt,
                           dateValue.ToString(standardFmt));
      Console.WriteLine();

      // Create an array of some custom format strings.
      string[] customFmts = {"h:mm:ss.ff t", "d MMM yyyy", "HH:mm:ss.f",
                             "dd MMM HH:mm:ss", @"\Mon\t\h\: M", "HH:mm:ss.ffffzzz" };
      // Output date and time using each custom format string.
      foreach (string customFmt in customFmts)
         Console.WriteLine("'{0}': {1}", customFmt,
                           dateValue.ToString(customFmt));
   }
}
// This example displays the following output to the console:
//       d: 6/15/2008
//       D: Sunday, June 15, 2008
//       f: Sunday, June 15, 2008 9:15 PM
//       F: Sunday, June 15, 2008 9:15:07 PM
//       g: 6/15/2008 9:15 PM
//       G: 6/15/2008 9:15:07 PM
//       m: June 15
//       o: 2008-06-15T21:15:07.0000000
//       R: Sun, 15 Jun 2008 21:15:07 GMT
//       s: 2008-06-15T21:15:07
//       t: 9:15 PM
//       T: 9:15:07 PM
//       u: 2008-06-15 21:15:07Z
//       U: Monday, June 16, 2008 4:15:07 AM
//       y: June, 2008
//
//       'h:mm:ss.ff t': 9:15:07.00 P
//       'd MMM yyyy': 15 Jun 2008
//       'HH:mm:ss.f': 21:15:07.0
//       'dd MMM HH:mm:ss': 15 Jun 21:15:07
//       '\Mon\t\h\: M': Month: 6
//       'HH:mm:ss.ffffzzz': 21:15:07.0000-07:00

Remarques

La ToString(String) méthode retourne la représentation sous forme de chaîne d’une valeur de date et d’heure dans un format spécifique qui utilise les conventions de mise en forme de la culture actuelle. Pour plus d’informations, consultez CultureInfo.CurrentCulture.

Le format paramètre doit contenir un caractère spécificateur de format unique (voir Chaînes de format de date et d’heure standard) ou un modèle de format personnalisé (voir Chaînes de format de date et d’heure personnalisées) qui définit le format de la chaîne retournée. Si format est null ou une chaîne vide, le spécificateur de format général« G » est utilisé.

Voici quelques utilisations de cette méthode :

• Obtention d’une chaîne qui affiche la date et l’heure dans le format de date et d’heure court de la culture actuelle. Pour ce faire, vous utilisez le spécificateur de format « G ».

• Obtention d’une chaîne qui contient uniquement le mois et l’année. Pour ce faire, vous utilisez la chaîne de format « MM/aaaa ». La chaîne de format utilise le séparateur de date de la culture actuelle.

• Obtention d’une chaîne qui contient la date et l’heure dans un format spécifique. Par exemple, la chaîne de format « MM/jj/aaaaH :mm » affiche la chaîne de date et d’heure dans un format fixe tel que « 19/03//2013 18 :06 ». La chaîne de format utilise « / » comme séparateur de date fixe, quels que soient les paramètres propres à la culture.

• Obtention d’une date dans un format condensé qui peut être utilisée pour sérialiser une chaîne de date. Par exemple, la chaîne de format « aaaaMMdd » affiche une année à quatre chiffres suivie d’un mois à deux chiffres et d’un jour à deux chiffres sans séparateur de date.

L’exemple suivant utilise ces trois chaînes de format pour afficher une valeur de date et d’heure à l’aide des conventions des cultures en-US et fr-FR.

C#

using System;
using System.Globalization;

public class ToStringExample5
{
    public static void Main3()
    {
        string[] formats = { "G", "MM/yyyy", @"MM\/dd\/yyyy HH:mm", "yyyyMMdd" };
        string[] cultureNames = { "en-US", "fr-FR" };
        DateTime date = new DateTime(2015, 8, 18, 13, 31, 17);
        foreach (var cultureName in cultureNames)
        {
            var culture = new CultureInfo(cultureName);
            CultureInfo.CurrentCulture = culture;
            Console.WriteLine(culture.NativeName);
            foreach (var format in formats)
                Console.WriteLine($"   {format}: {date.ToString(format)}");
            Console.WriteLine();
        }
    }
}
// The example displays the following output:
//       English (United States)
//          G: 8/18/2015 1:31:17 PM
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818
//
//       français (France)
//          G: 18/08/2015 13:31:17
//          MM/yyyy: 08/2015
//          MM\/dd\/yyyy HH:mm: 08/18/2015 13:31
//          yyyyMMdd: 20150818

Notes pour les appelants

La ToString(String) méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par la culture actuelle. Si la valeur de l’instance actuelle DateTime est antérieure MinSupportedDateTime ou ultérieure à MaxSupportedDateTime, la méthode lève un ArgumentOutOfRangeException. L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui est en dehors de la plage de la HebrewCalendar classe lorsque la culture actuelle est hébreu (Israël).

C#

using System;
using System.Globalization;
using System.Threading;

public class Example3
{
    public static void Main()
    {
        DateTime date1 = new DateTime(1550, 7, 21);
        CultureInfo dft;
        CultureInfo heIL = new CultureInfo("he-IL");
        heIL.DateTimeFormat.Calendar = new HebrewCalendar();

        // Change current culture to he-IL.
        dft = Thread.CurrentThread.CurrentCulture;
        Thread.CurrentThread.CurrentCulture = heIL;

        // Display the date using the current culture's calendar.
        try
        {
            Console.WriteLine(date1.ToString("G"));
        }
        catch (ArgumentOutOfRangeException)
        {
            Console.WriteLine("{0} is earlier than {1} or later than {2}",
                              date1.ToString("d", CultureInfo.InvariantCulture),
                              heIL.DateTimeFormat.Calendar.MinSupportedDateTime.ToString("d", CultureInfo.InvariantCulture),
                              heIL.DateTimeFormat.Calendar.MaxSupportedDateTime.ToString("d", CultureInfo.InvariantCulture));
        }

        // Restore the default culture.
        Thread.CurrentThread.CurrentCulture = dft;
    }
}
// The example displays the following output:
//    07/21/1550 is earlier than 01/01/1583 or later than 09/29/2239

Voir aussi

• DateTimeFormatInfo
• CultureInfo
• Mettre en forme des types dans .NET
• Chaînes de format de date et d'heure standard
• Chaînes de format de date et d’heure personnalisées

ToString()

Source:

DateTime.cs

Convertit la valeur de l’objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l’aide des conventions de mise en forme de la culture actuelle.

C#

public override string ToString ();

Retours

String

Représentation sous forme de chaîne de la valeur de l'objet DateTime actuel.

Exceptions

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par la culture actuelle.

Exemples

L’exemple suivant illustre la façon dont la représentation sous forme de chaîne d’une DateTime valeur retournée par la ToString() méthode dépend de la culture actuelle du thread. Il change la culture actuelle en en-US, fr-FR et ja-JP, et dans chaque cas appelle la ToString() méthode pour retourner la représentation sous forme de chaîne d’une valeur de date et d’heure à l’aide de cette culture.

C#

using System;
using System.Globalization;

public class ToStringExample1
{
    public static void Main()
    {
        CultureInfo currentCulture = CultureInfo.CurrentCulture;
        DateTime exampleDate = new DateTime(2021, 5, 1, 18, 32, 6);

        // Change the current culture to en-US and display the date.
        CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("en-US");
        Console.WriteLine(exampleDate.ToString());

        // Change the current culture to fr-FR and display the date.
        CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("fr-FR");
        Console.WriteLine(exampleDate.ToString());

        // Change the current culture to ja-JP and display the date.
        CultureInfo.CurrentCulture = CultureInfo.GetCultureInfo("ja-JP");
        Console.WriteLine(exampleDate.ToString());

        // Restore the original culture
        CultureInfo.CurrentCulture = currentCulture;
    }
}

// The example displays the following output to the console:
//       5/1/2021 6:32:06 PM
//       01/05/2021 18:32:06
//       2021/05/01 18:32:06

Remarques

La valeur de l’objet actuel DateTime est mise en forme à l’aide du spécificateur de format général de date et d’heure (« G »). Pour le mettre en forme à l’aide d’un spécificateur de format de date et d’heure spécifique, appelez la ToString(String) méthode . Pour le mettre en forme à l’aide du spécificateur de format de date et d’heure général (« G ») pour une culture spécifique, appelez la ToString(IFormatProvider) méthode . Pour le mettre en forme à l’aide d’un spécificateur de format de date et d’heure spécifique et des conventions d’une culture spécifique, appelez la ToString(String, IFormatProvider) méthode .

Cette méthode utilise des informations de mise en forme dérivées de la culture actuelle. En particulier, il combine les chaînes de format personnalisées retournées par les ShortDatePattern propriétés et LongTimePattern de l’objet DateTimeFormatInfo retourné par la Thread.CurrentThread.CurrentCulture.DateTimeFormat propriété . Pour plus d'informations, consultez CultureInfo.CurrentCulture. D’autres surcharges de la ToString méthode vous permettent de spécifier la culture dont la mise en forme doit être utilisée et de définir le modèle de sortie de la DateTime valeur.

Notes pour les appelants

La ToString() méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par la culture actuelle. Si la valeur de l’instance actuelle DateTime est antérieure MinSupportedDateTime ou ultérieure à MaxSupportedDateTime, la méthode lève un ArgumentOutOfRangeException. L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui est en dehors de la plage de la HijriCalendar classe lorsque la culture actuelle est arabe (Syrie).

C#

using System;
using System.Globalization;
using System.Threading;

public class Example2
{
    public static void Main()
    {
        DateTime date1 = new DateTime(550, 1, 1);
        CultureInfo dft;
        CultureInfo arSY = new CultureInfo("ar-SY");
        arSY.DateTimeFormat.Calendar = new HijriCalendar();

        // Change current culture to ar-SY.
        dft = Thread.CurrentThread.CurrentCulture;
        Thread.CurrentThread.CurrentCulture = arSY;

        // Display the date using the current culture's calendar.
        try
        {
            Console.WriteLine(date1.ToString());
        }
        catch (ArgumentOutOfRangeException)
        {
            Console.WriteLine("{0} is earlier than {1} or later than {2}",
                              date1.ToString("d", CultureInfo.InvariantCulture),
                              arSY.DateTimeFormat.Calendar.MinSupportedDateTime.ToString("d", CultureInfo.InvariantCulture),
                              arSY.DateTimeFormat.Calendar.MaxSupportedDateTime.ToString("d", CultureInfo.InvariantCulture));
        }

        // Restore the default culture.
        Thread.CurrentThread.CurrentCulture = dft;
    }
}
// The example displays the following output:
//    01/01/0550 is earlier than 07/18/0622 or later than 12/31/9999

Voir aussi

• DateTimeFormatInfo
• CultureInfo

ToString(String, IFormatProvider)

Source:

DateTime.cs

Convertit la valeur de l'objet DateTime actuel en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de format spécifiques à la culture spécifiés.

C#

public string ToString (string? format, IFormatProvider? provider);

Paramètres

format

String

Chaîne de format de date et d'heure standard ou personnalisée.

provider

IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de la valeur de l'objet DateTime actuel tel que spécifié par format et provider.

Implémente

ToString(String, IFormatProvider)

Exceptions

FormatException

La longueur de format est 1, et ce n’est pas l’un des caractères spécificateurs de format définis pour DateTimeFormatInfo.

- ou -

format ne contient pas un modèle de format personnalisé valide.

ArgumentOutOfRangeException

La date et l’heure sont en dehors de la plage de dates prise en charge par le calendrier utilisé par provider.

Exemples

L’exemple suivant utilise chacune des chaînes de format de date et d’heure standard pour afficher la représentation sous forme de chaîne d’une date et d’une heure pour quatre cultures différentes.

C#

using System;
using System.Globalization;

public class ToStringExample4
{
   public static void Main1()
   {
      // Create an array of all supported standard date and time format specifiers.
      string[] formats = {"d", "D", "f", "F", "g", "G", "m", "o", "r",
                          "s", "t", "T", "u", "U", "Y"};
      // Create an array of four cultures.
      CultureInfo[] cultures = {CultureInfo.GetCultureInfo("de-DE"),
                                CultureInfo.GetCultureInfo("en-US"),
                                CultureInfo.GetCultureInfo("es-ES"),
                                CultureInfo.GetCultureInfo("fr-FR")};
       // Define date to be displayed.
      DateTime dateToDisplay = new DateTime(2008, 10, 31, 17, 4, 32);

      // Iterate each standard format specifier.
      foreach (string formatSpecifier in formats)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0} Format Specifier {1, 10} Culture {2, 40}",
                              formatSpecifier, culture.Name,
                              dateToDisplay.ToString(formatSpecifier, culture));
         Console.WriteLine();
      }
   }
}

// The example displays the following output:
//    d Format Specifier      de-DE Culture                               31.10.2008
//    d Format Specifier      en-US Culture                               10/31/2008
//    d Format Specifier      es-ES Culture                               31/10/2008
//    d Format Specifier      fr-FR Culture                               31/10/2008
//    
//    D Format Specifier      de-DE Culture                Freitag, 31. Oktober 2008
//    D Format Specifier      en-US Culture                 Friday, October 31, 2008
//    D Format Specifier      es-ES Culture           viernes, 31 de octubre de 2008
//    D Format Specifier      fr-FR Culture                 vendredi 31 octobre 2008
//    
//    f Format Specifier      de-DE Culture          Freitag, 31. Oktober 2008 17:04
//    f Format Specifier      en-US Culture         Friday, October 31, 2008 5:04 PM
//    f Format Specifier      es-ES Culture     viernes, 31 de octubre de 2008 17:04
//    f Format Specifier      fr-FR Culture           vendredi 31 octobre 2008 17:04
//    
//    F Format Specifier      de-DE Culture       Freitag, 31. Oktober 2008 17:04:32
//    F Format Specifier      en-US Culture      Friday, October 31, 2008 5:04:32 PM
//    F Format Specifier      es-ES Culture  viernes, 31 de octubre de 2008 17:04:32
//    F Format Specifier      fr-FR Culture        vendredi 31 octobre 2008 17:04:32
//    
//    g Format Specifier      de-DE Culture                         31.10.2008 17:04
//    g Format Specifier      en-US Culture                       10/31/2008 5:04 PM
//    g Format Specifier      es-ES Culture                         31/10/2008 17:04
//    g Format Specifier      fr-FR Culture                         31/10/2008 17:04
//    
//    G Format Specifier      de-DE Culture                      31.10.2008 17:04:32
//    G Format Specifier      en-US Culture                    10/31/2008 5:04:32 PM
//    G Format Specifier      es-ES Culture                      31/10/2008 17:04:32
//    G Format Specifier      fr-FR Culture                      31/10/2008 17:04:32
//    
//    m Format Specifier      de-DE Culture                              31. Oktober
//    m Format Specifier      en-US Culture                               October 31
//    m Format Specifier      es-ES Culture                            31 de octubre
//    m Format Specifier      fr-FR Culture                               31 octobre
//    
//    o Format Specifier      de-DE Culture              2008-10-31T17:04:32.0000000
//    o Format Specifier      en-US Culture              2008-10-31T17:04:32.0000000
//    o Format Specifier      es-ES Culture              2008-10-31T17:04:32.0000000
//    o Format Specifier      fr-FR Culture              2008-10-31T17:04:32.0000000
//    
//    r Format Specifier      de-DE Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    r Format Specifier      en-US Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    r Format Specifier      es-ES Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    r Format Specifier      fr-FR Culture            Fri, 31 Oct 2008 17:04:32 GMT
//    
//    s Format Specifier      de-DE Culture                      2008-10-31T17:04:32
//    s Format Specifier      en-US Culture                      2008-10-31T17:04:32
//    s Format Specifier      es-ES Culture                      2008-10-31T17:04:32
//    s Format Specifier      fr-FR Culture                      2008-10-31T17:04:32
//    
//    t Format Specifier      de-DE Culture                                    17:04
//    t Format Specifier      en-US Culture                                  5:04 PM
//    t Format Specifier      es-ES Culture                                    17:04
//    t Format Specifier      fr-FR Culture                                    17:04
//    
//    T Format Specifier      de-DE Culture                                 17:04:32
//    T Format Specifier      en-US Culture                               5:04:32 PM
//    T Format Specifier      es-ES Culture                                 17:04:32
//    T Format Specifier      fr-FR Culture                                 17:04:32
//    
//    u Format Specifier      de-DE Culture                     2008-10-31 17:04:32Z
//    u Format Specifier      en-US Culture                     2008-10-31 17:04:32Z
//    u Format Specifier      es-ES Culture                     2008-10-31 17:04:32Z
//    u Format Specifier      fr-FR Culture                     2008-10-31 17:04:32Z
//    
//    U Format Specifier      de-DE Culture       Freitag, 31. Oktober 2008 09:04:32
//    U Format Specifier      en-US Culture      Friday, October 31, 2008 9:04:32 AM
//    U Format Specifier      es-ES Culture   viernes, 31 de octubre de 2008 9:04:32
//    U Format Specifier      fr-FR Culture        vendredi 31 octobre 2008 09:04:32
//    
//    Y Format Specifier      de-DE Culture                             Oktober 2008
//    Y Format Specifier      en-US Culture                             October 2008
//    Y Format Specifier      es-ES Culture                          octubre de 2008
//    Y Format Specifier      fr-FR Culture                             octobre 2008

L’exemple suivant illustre différentes façons de mettre en forme une DateTime valeur à l’aide de l’invariant DateTimeFormatInfo.

C#

using System;
using System.Globalization;

public class MainClass
{
    public static void Main(string[] args)
    {
        DateTime dt = DateTime.Now;
        String[] format = {
            "d", "D",
            "f", "F",
            "g", "G",
            "m",
            "r",
            "s",
            "t", "T",
            "u", "U",
            "y",
            "dddd, MMMM dd yyyy",
            "ddd, MMM d \"'\"yy",
            "dddd, MMMM dd",
            "M/yy",
            "dd-MM-yy",
        };
        string date;
        for (int i = 0; i < format.Length; i++)
        {
            date = dt.ToString(format[i], DateTimeFormatInfo.InvariantInfo);
            Console.WriteLine(string.Concat(format[i], " :", date));
        }

        /** Output.
         *
         * d :08/17/2000
         * D :Thursday, August 17, 2000
         * f :Thursday, August 17, 2000 16:32
         * F :Thursday, August 17, 2000 16:32:32
         * g :08/17/2000 16:32
         * G :08/17/2000 16:32:32
         * m :August 17
         * r :Thu, 17 Aug 2000 23:32:32 GMT
         * s :2000-08-17T16:32:32
         * t :16:32
         * T :16:32:32
         * u :2000-08-17 23:32:32Z
         * U :Thursday, August 17, 2000 23:32:32
         * y :August, 2000
         * dddd, MMMM dd yyyy :Thursday, August 17 2000
         * ddd, MMM d "'"yy :Thu, Aug 17 '00
         * dddd, MMMM dd :Thursday, August 17
         * M/yy :8/00
         * dd-MM-yy :17-08-00
         */
    }
}

Remarques

Le format paramètre peut contenir un caractère spécificateur de format unique (voir Chaînes de format de date et d’heure standard) ou un modèle de format personnalisé (voir Chaînes de format de date et d’heure personnalisées). Si format est null ou une chaîne vide ( » « ), le spécificateur de format standard, « G », est utilisé.

Le provider paramètre définit le modèle qui correspond aux spécificateurs de format standard, ainsi que les symboles et les noms des composants de date et d’heure. Le provider paramètre peut être l’un des éléments suivants :

• Objet CultureInfo qui représente la culture dont les conventions de mise en forme doivent être reflétées dans la chaîne retournée. L’objet DateTimeFormatInfo retourné par la CultureInfo.DateTimeFormat propriété définit la mise en forme de la chaîne retournée.

• Objet DateTimeFormatInfo qui définit le format des données de date et d’heure.

• Objet personnalisé qui implémente l’interface IFormatProvider . Sa GetFormat méthode retourne un DateTimeFormatInfo objet qui fournit des informations de mise en forme.

Si provider est null, le DateTimeFormatInfo associé à la culture actuelle est utilisé. Pour plus d'informations, consultez CultureInfo.CurrentCulture.

Notes pour les appelants

La ToString(String, IFormatProvider) méthode retourne la représentation sous forme de chaîne de la date et de l’heure dans le calendrier utilisé par le provider paramètre . Son calendrier est défini par la Calendar propriété . Si la valeur de l’instance actuelle DateTime est antérieure MinSupportedDateTime ou ultérieure à MaxSupportedDateTime, la méthode lève un ArgumentOutOfRangeException. L'exemple suivant illustre cette situation. Il tente de mettre en forme une date qui se trouve en dehors de la plage de la UmAlQuraCalendar classe .

C#

using System;
using System.Globalization;

public class Example4
{
    public static void Main()
    {
        CultureInfo arSA = new CultureInfo("ar-SA");
        arSA.DateTimeFormat.Calendar = new UmAlQuraCalendar();
        DateTime date1 = new DateTime(1890, 9, 10);

        try
        {
            Console.WriteLine(date1.ToString("d", arSA));
        }
        catch (ArgumentOutOfRangeException)
        {
            Console.WriteLine("{0:d} is earlier than {1:d} or later than {2:d}",
                              date1,
                              arSA.DateTimeFormat.Calendar.MinSupportedDateTime,
                              arSA.DateTimeFormat.Calendar.MaxSupportedDateTime);
        }
    }
}
// The example displays the following output:
//    9/10/1890 is earlier than 4/30/1900 or later than 5/13/2029

Voir aussi

• DateTimeFormatInfo
• CultureInfo
• Mettre en forme des types dans .NET
• Chaînes de format de date et d'heure standard
• Custom Date and Time Format Strings
• Exemple : utilitaire de mise en forme .NET Core WinForms (C#)
• Exemple : utilitaire de mise en forme .NET Core WinForms (Visual Basic)