Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

DateTime.ToString, méthode (String)

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

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.

ExceptionCondition
FormatException

La longueur de format est 1 et il ne s'agit pas d'un des caractères spécificateurs de format définis pour DateTimeFormatInfo.

ou

format ne contient pas de 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 paramètre format 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é (consultez Chaînes de format de date et d'heure personnalisées) définissant 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é.

Cette méthode utilise les informations de mise en forme dérivées de la culture actuelle. Pour plus d'informations, consultez CurrentCulture.

Remarques à l'attention des appelants

La méthode ToString(String) retourne la représentation sous forme de chaîne des date et heure dans le calendrier utilisé par la culture actuelle. Si la valeur de l'instance de DateTime actuelle est antérieure à Calendar.MinSupportedDateTime ou ultérieure à Calendar.MaxSupportedDateTime, la méthode lève une exception ArgumentOutOfRangeException. L'exemple suivant illustre cette situation. Il essaie de mettre en forme une date qui est à l'extérieur de la plage de la classe HebrewCalendar lorsque 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 de date et d'heure standard, ainsi qu'une sélection de chaînes de format de date et d'heure personnalisé pour la représentation sous forme de chaîne d'une valeur DateTime. La culture actuelle du thread dans cet 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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

Afficher:
© 2014 Microsoft