Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

TimeSpan.ToString, méthode (String, IFormatProvider)

Convertit la valeur de l'objet TimeSpan actif en 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 spécifiques à 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.

Implémentations

IFormattable.ToString(String, IFormatProvider)

ExceptionCondition
FormatException

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

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

Remarque importanteImportant

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

Le .NET Framework assure une prise en charge étendue de la mise en forme, décrite plus en détail dans les rubriques suivantes relatives à la mise en forme :

Le paramètre formatProvider est une implémentation de IFormatProvider qui fournit les informations spécifiques à la culture concernant le format de la chaîne retournée. Le paramètre formatProvider peut être n'importe lequel des éléments suivants :

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

L'exemple suivant appelle la méthode ToString(String, IFormatProvider) pour mettre en forme deux intervalles de temps. L'exemple appelle la méthode deux fois pour chaque chaîne de format, d'abord pour l'afficher à l'aide des conventions de la culture en-US, ensuite pour l'afficher à l'aide des 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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Pris en charge dans : 4

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é

AJOUTER
Afficher:
© 2014 Microsoft