Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DateTime.ToString méthode (String)

 

Date de publication : novembre 2016

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

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

public string ToString(
	string format
)

Paramètres

format
Type: System.String

Chaîne de format de date et d'heure standard ou personnalisée (consultez la section Notes).

Valeur de retour

Type: System.String

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

Exception Condition
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.

Le 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 (consultez 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ée.

Certaines utilisations de cette méthode sont les suivantes :

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

  • Obtention d’une chaîne qui contienne 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, le « MM/JJ/yyyyHH:mm » chaîne de format affiche la chaîne de date et d’heure dans un format fixe tel que « 19 2013 / / 03 / / 18:06 ». La chaîne de format utilise « / » comme séparateur de date fixe, quels que soient les paramètres spécifiques à la culture.

  • Obtention d’une date dans un format condensée qui peut être utilisé pour la sérialisation d’une chaîne de date. Par exemple, la chaîne de format « AAAAMMJJ » affiche une année à quatre chiffres suivie d’un mois à deux chiffres et 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 en utilisant les conventions des cultures en-US et fr-FR.

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

public class Example
{
   public static void Main()
   {
      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("   {0}: {1}", 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

Remarques à l’attention des appelants :

Le ToString(String) méthode retourne la représentation sous forme de chaîne de date et heure dans le calendrier utilisé par la culture actuelle. Si la valeur de la DateTime instance est antérieure à Calendar.MinSupportedDateTime ou postérieur à Calendar.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 lors de la culture actuelle est hébreu (Israël).

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

public class Example
{
   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

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

using System;

public class DateToStringExample
{
   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

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: