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

TimeSpan.ToString méthode (String, IFormatProvider)

 

Date de publication : novembre 2016

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

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

public string ToString(
	string format,
	IFormatProvider formatProvider
)

Paramètres

format
Type: System.String

Chaîne de format TimeSpan standard ou personnalisé.

formatProvider
Type: System.IFormatProvider

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

Valeur de retour

Type: System.String

Représentation sous forme de chaîne de la valeur actuelle de TimeSpan, tel que spécifié par format et formatProvider.

Exception Condition
FormatException

Le paramètre format n’est pas reconnu ou n’est pas pris en charge.

Le format paramètre peut être n’importe quel spécificateur de format standard ou personnalisé valide pour TimeSpan valeurs. Si format est égal à String.Empty ou null, la valeur de retour du courant TimeSpan objet est mis en forme avec le spécificateur de format commun (« c »). Si le format est n’importe quelle autre valeur, la méthode lève un FormatException.

System_CAPS_importantImportant

Chaînes de format personnalisé pour TimeSpan valeurs n’incluent pas un séparateur de date ou d’heure. Si vous souhaitez inclure ces éléments dans votre chaîne de format, vous devez les traiter comme des littéraux de caractère. Consultez l’exemple pour obtenir une illustration et le Chaînes de format TimeSpan personnalisées rubrique pour plus d’informations.

Le .NET Framework fournit une prise en charge complète de la mise en forme, est décrite en détail dans les rubriques de mise en forme suivantes :

Le formatProvider paramètre est un IFormatProvider implémentation qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée. Le formatProvider paramètre peut être une des opérations suivantes :

Si formatProvider est null, le DateTimeFormatInfo objet est associé à la culture actuelle est utilisé. Si format est une chaîne de format personnalisé, le formatProvider paramètre est ignoré.

L’exemple suivant appelle la ToString(String, IFormatProvider) méthode pour le formatage de deux intervalles de temps. L’exemple appelle la méthode deux fois pour chaque chaîne de format, tout d’abord d’affichage en utilisant les conventions de la culture en-US, puis d’affichage en utilisant les conventions de la culture fr-FR.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      TimeSpan[] intervals = { new TimeSpan(38, 30, 15), 
                               new TimeSpan(16, 14, 30) }; 
      CultureInfo[] cultures = { new CultureInfo("en-US"), 
                                 new CultureInfo("fr-FR") };
      string[] formats = {"c", "g", "G", @"hh\:mm\:ss" };
      Console.WriteLine("{0,12}      Format  {1,22}  {2,22}\n", 
                        "Interval", cultures[0].Name, cultures[1].Name);

      foreach (var interval in intervals) {
         foreach (var fmt in formats)
            Console.WriteLine("{0,12}  {1,10}  {2,22}  {3,22}", 
                              interval, fmt, 
                              interval.ToString(fmt, cultures[0]), 
                              interval.ToString(fmt, cultures[1]));
         Console.WriteLine();
      }  
   }
}
// The example displays the following output:
//        Interval      Format                   en-US                   fr-FR
//    
//      1.14:30:15           c              1.14:30:15              1.14:30:15
//      1.14:30:15           g              1:14:30:15              1:14:30:15
//      1.14:30:15           G      1:14:30:15.0000000      1:14:30:15,0000000
//      1.14:30:15  hh\:mm\:ss                14:30:15                14:30:15
//    
//        16:14:30           c                16:14:30                16:14:30
//        16:14:30           g                16:14:30                16:14:30
//        16:14:30           G      0:16:14:30.0000000      0:16:14:30,0000000
//        16:14:30  hh\:mm\:ss                16:14:30                16:14:30

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