TimeSpan.ToString Méthode

Définition

Convertit la valeur de l'objet TimeSpan actif en sa représentation équivalente sous forme de chaîne.Converts the value of the current TimeSpan object to its equivalent string representation.

Surcharges

ToString(String, IFormatProvider)

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.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format and culture-specific formatting information.

ToString(String)

Convertit la valeur de l'objet TimeSpan actuel dans sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format.

ToString()

Convertit la valeur de l'objet TimeSpan actif en sa représentation équivalente sous forme de chaîne.Converts the value of the current TimeSpan object to its equivalent string representation.

ToString(String, IFormatProvider)

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.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format and culture-specific formatting information.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ formatProvider);
public string ToString (string format, IFormatProvider formatProvider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, formatProvider As IFormatProvider) As String

Paramètres

format
String

Chaîne de format TimeSpan standard ou personnalisé.A standard or custom TimeSpan format string.

formatProvider
IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.An object that supplies culture-specific formatting information.

Retours

Représentation sous forme de chaîne de la valeur actuelle de TimeSpan, tel que spécifié par format et formatProvider.The string representation of the current TimeSpan value, as specified by format and formatProvider.

Implémente

Exceptions

Le paramètre format n’est pas reconnu ou n’est pas pris en charge.The format parameter is not recognized or is not supported.

Exemples

L’exemple suivant appelle la méthode ToString(String, IFormatProvider) pour mettre en forme deux intervalles de temps.The following example calls the ToString(String, IFormatProvider) method to format two time intervals. L’exemple appelle la méthode deux fois pour chaque chaîne de format, avant de l’afficher à l’aide des conventions de la culture en-US, puis de l’afficher à l’aide des conventions de la culture fr-FR.The example calls the method twice for each format string, first to display it using the conventions of the en-US culture and then to display it using the conventions of the fr-FR culture.

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
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim intervals() As TimeSpan = { New TimeSpan(38, 30, 15), 
                                      New TimeSpan(16, 14, 30) } 
      Dim cultures() As CultureInfo = { New CultureInfo("en-US"), 
                                        New CultureInfo("fr-FR") }
      Dim formats() As String = {"c", "g", "G", "hh\:mm\:ss" }
      Console.WriteLine("{0,12}      Format  {1,22}  {2,22}", 
                        "Interval", cultures(0).Name, cultures(1).Name)
      Console.WriteLine()
      For Each interval In intervals
         For Each 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)))
         Next
         Console.WriteLine()
      Next                                                                                                                                            
   End Sub
End Module
' 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

Remarques

Le paramètre format peut être n’importe quel spécificateur de format standard ou personnalisé valide pour les valeurs TimeSpan.The format parameter can be any valid standard or custom format specifier for TimeSpan values. 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").If format is equal to String.Empty or is null, the return value of the current TimeSpan object is formatted with the common format specifier ("c"). Si format est une autre valeur, la méthode lève une FormatException.If format is any other value, the method throws a FormatException.

Important

Les chaînes de format personnalisées pour les valeurs TimeSpan n’incluent pas de séparateur de date ou d’heure.The custom format strings for TimeSpan values do not include a date or time separator. Si vous souhaitez inclure ces éléments dans votre chaîne de format, vous devez les traiter comme des littéraux de caractère.If you want to include these elements in your format string, you must treat them as character literals. Pour plus d’informations, consultez l’exemple d’une illustration et la rubrique chaînes de format TimeSpan personnalisées .See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

Le .NET Framework fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Le paramètre formatProvider est une implémentation IFormatProvider qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée.The formatProvider parameter is an IFormatProvider implementation that provides culture-specific information about the format of the returned string. Le paramètre formatProvider peut être l’un des éléments suivants :The formatProvider parameter can be any of the following:

Si formatProvider est null, l’objet DateTimeFormatInfo associé à la culture actuelle est utilisé.If formatProvider is null, the DateTimeFormatInfo object that is associated with the current culture is used. Si format est une chaîne de format personnalisée, le paramètre formatProvider est ignoré.If format is a custom format string, the formatProvider parameter is ignored.

Voir aussi

ToString(String)

Convertit la valeur de l'objet TimeSpan actuel dans sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Paramètres

format
String

Chaîne de format TimeSpan standard ou personnalisé.A standard or custom TimeSpan format string.

Retours

Représentation sous forme de chaîne de la valeur actuelle de TimeSpan au format spécifié par le paramètre format.The string representation of the current TimeSpan value in the format specified by the format parameter.

Exceptions

Le paramètre format n’est pas reconnu ou n’est pas pris en charge.The format parameter is not recognized or is not supported.

Exemples

L’exemple suivant utilise des chaînes de format de TimeSpan standard et personnalisées pour afficher la représentation sous forme de chaîne de chaque élément dans un tableau de valeurs TimeSpanThe following example uses standard and custom TimeSpan format strings to display the string representation of each element in an array of TimeSpan values

TimeSpan[] spans = { 
   TimeSpan.Zero, 
   new TimeSpan(-14, 0, 0, 0, 0), 
   new TimeSpan(1, 2, 3), 
   new TimeSpan(0, 0, 0, 0, 250), 
   new TimeSpan(99, 23, 59, 59, 999),
   new TimeSpan(3, 0, 0), 
   new TimeSpan(0, 0, 0, 0, 25) 
};

string[] fmts = { "c", "g", "G", @"hh\:mm\:ss", "%m' min.'" };
foreach (TimeSpan span in spans)
{
   foreach (string fmt in fmts)
      Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt));

   Console.WriteLine();
}
// The example displays the following output:
//       c: 00:00:00
//       g: 0:00:00
//       G: 0:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: -14.00:00:00
//       g: -14:0:00:00
//       G: -14:00:00:00.0000000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 01:02:03
//       g: 1:02:03
//       G: 0:01:02:03.0000000
//       hh\:mm\:ss: 01:02:03
//       %m' min.': 2 min.
//       
//       c: 00:00:00.2500000
//       g: 0:00:00.25
//       G: 0:00:00:00.2500000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
//       
//       c: 99.23:59:59.9990000
//       g: 99:23:59:59.999
//       G: 99:23:59:59.9990000
//       hh\:mm\:ss: 23:59:59
//       %m' min.': 59 min.
//       
//       c: 03:00:00
//       g: 3:00:00
//       G: 0:03:00:00.0000000
//       hh\:mm\:ss: 03:00:00
//       %m' min.': 0 min.
//       
//       c: 00:00:00.0250000
//       g: 0:00:00.025
//       G: 0:00:00:00.0250000
//       hh\:mm\:ss: 00:00:00
//       %m' min.': 0 min.
Module Example
   Public Sub Main()
      Dim spans() As TimeSpan = { TimeSpan.Zero, New TimeSpan(-14, 0, 0, 0, 0), 
                                  New TimeSpan(1, 2, 3), 
                                  New TimeSpan(0, 0, 0, 0, 250), 
                                  New TimeSpan(99, 23, 59, 59, 999),
                                  New TimeSpan(3, 0, 0), 
                                  New TimeSpan(0, 0, 0, 0, 25) }
      Dim fmts() As String = { "c", "g", "G", "hh\:mm\:ss", "%m' min.'" }
      For Each span As TimeSpan In spans
         For Each fmt As String In fmts
            Console.WriteLine("{0}: {1}", fmt, span.ToString(fmt))
         Next
         Console.WriteLine()         
      Next
   End Sub
End Module
' The example displays the following output:
'       c: 00:00:00
'       g: 0:00:00
'       G: 0:00:00:00.0000000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.
'       
'       c: -14.00:00:00
'       g: -14:0:00:00
'       G: -14:00:00:00.0000000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.
'       
'       c: 01:02:03
'       g: 1:02:03
'       G: 0:01:02:03.0000000
'       hh\:mm\:ss: 01:02:03
'       %m' min.': 2 min.
'       
'       c: 00:00:00.2500000
'       g: 0:00:00.25
'       G: 0:00:00:00.2500000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.
'       
'       c: 99.23:59:59.9990000
'       g: 99:23:59:59.999
'       G: 99:23:59:59.9990000
'       hh\:mm\:ss: 23:59:59
'       %m' min.': 59 min.
'       
'       c: 03:00:00
'       g: 3:00:00
'       G: 0:03:00:00.0000000
'       hh\:mm\:ss: 03:00:00
'       %m' min.': 0 min.
'       
'       c: 00:00:00.0250000
'       g: 0:00:00.025
'       G: 0:00:00:00.0250000
'       hh\:mm\:ss: 00:00:00
'       %m' min.': 0 min.

Remarques

Le paramètre format peut être n’importe quel spécificateur de format standard ou personnalisé valide pour les valeurs TimeSpan.The format parameter can be any valid standard or custom format specifier for TimeSpan values. 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").If format is equal to String.Empty or is null, the return value of the current TimeSpan object is formatted with the common format specifier ("c"). Si format est une autre valeur, la méthode lève une FormatException.If format is any other value, the method throws a FormatException.

Si format est une chaîne de format standard, le format de la chaîne retournée est défini par les conventions de mise en forme de la culture actuelle.If format is a standard format string, the format of the returned string is defined by the formatting conventions of the current culture.

Important

Les chaînes de format personnalisées pour les valeurs TimeSpan n’incluent pas de séparateur de date ou d’heure.The custom format strings for TimeSpan values do not include a date or time separator. Si vous souhaitez inclure ces éléments dans votre chaîne de format, vous devez les traiter comme des littéraux de caractère.If you want to include these elements in your format string, you must treat them as character literals. Pour plus d’informations, consultez l’exemple d’une illustration et la rubrique chaînes de format TimeSpan personnalisées .See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

Le .NET Framework fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Voir aussi

ToString()

Convertit la valeur de l'objet TimeSpan actif en sa représentation équivalente sous forme de chaîne.Converts the value of the current TimeSpan object to its equivalent string representation.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Retours

Représentation sous forme de chaîne de la valeur actuelle de TimeSpan.The string representation of the current TimeSpan value.

Exemples

L’exemple suivant affiche les chaînes retournées en appelant la méthode ToString avec un certain nombre de valeurs TimeSpan.The following example displays the strings returned by calling the ToString method with a number of TimeSpan values. Notez que même si l’exemple n’appelle pas directement la méthode ToString, il est appelé par la méthode Console.WriteLine lorsqu’il tente de convertir une valeur TimeSpan en sa représentation sous forme de chaîne.Note that although the example does not call the ToString method directly, it is called by the Console.WriteLine method when it attempts to convert a TimeSpan value to its string representation.

 TimeSpan span;
 
 // Initialize a time span to zero.
 span = TimeSpan.Zero;
 Console.WriteLine(span);

 // Initialize a time span to 14 days.
 span = new TimeSpan(-14, 0, 0, 0, 0);
 Console.WriteLine(span);

 // Initialize a time span to 1:02:03.
 span = new TimeSpan(1, 2, 3);
 Console.WriteLine(span);

 // Initialize a time span to 250 milliseconds.
 span = new TimeSpan(0, 0, 0, 0, 250);
 Console.WriteLine(span);
 
 // Initalize a time span to 99 days, 23 hours, 59 minutes, and 59.999 seconds.
 span = new TimeSpan(99, 23, 59, 59, 999);
 Console.WriteLine(span);
 
 // Initalize a time span to 3 hours.
 span = new TimeSpan(3, 0, 0);
 Console.WriteLine(span);
 
 // Initalize a timespan to 25 milliseconds.
 span = new TimeSpan(0, 0, 0, 0, 25);
 Console.WriteLine(span);

 // The example displays the following output:
 //       00:00:00
 //       -14.00:00:00
 //       01:02:03
 //       00:00:00.2500000
 //       99.23:59:59.9990000
 //       03:00:00
 //       00:00:00.0250000
Module ToString
   Public Sub Main()
      Dim span As TimeSpan
      
      ' Initialize a time span to zero.
      span = TimeSpan.Zero
      Console.WriteLine(span)
      
      ' Initialize a time span to 14 days.
      span = New TimeSpan(-14, 0, 0, 0, 0)
      Console.WriteLine(span)
     
      ' Initialize a time span to 1:02:03.
      span = New TimeSpan(1, 2, 3)
      Console.WriteLine(span)
      
      
      ' Initialize a time span to 250 milliseconds.
      span = New TimeSpan(0, 0, 0, 0, 250)
      Console.WriteLine(span)
      
      ' Initalize a time span to 99 days, 23 hours, 59 minutes, and 59.9999999 seconds.
      span = New TimeSpan(99, 23, 59, 59, 999)
      Console.WriteLine(span)
      
      ' Initalize a time span to 3 hours.
      span = New TimeSpan(3, 0, 0)
      Console.WriteLine(span)
      
      ' Initalize a timespan to 25 milliseconds.
      span = New TimeSpan(0, 0, 0, 0, 25)
      Console.WriteLine(span)
   End Sub
End Module
' The example displays the following output:
'       00:00:00
'       -14.00:00:00
'       01:02:03
'       00:00:00.2500000
'       99.23:59:59.9990000
'       03:00:00
'       00:00:00.0250000

Remarques

La chaîne retournée est mise en forme avec le spécificateur de format "c" et a le format suivant :The returned string is formatted with the "c" format specifier and has the following format:

[-][d.]hh:mm:ss[.fffffff][-][d.]hh:mm:ss[.fffffff]

Les éléments entre crochets ([et]) ne peuvent pas être inclus dans la chaîne retournée.Elements in square brackets ([ and ]) may not be included in the returned string. Les signes deux-points et les points ( : et) sont des caractères littéraux.Colons and periods (: and.) are literal characters. Les éléments non littéraux sont répertoriés dans le tableau suivant.The non-literal elements are listed in the following table. Notez que la chaîne retournée par la méthode ToString() n’est pas dépendante de la culture.Note that the string returned by the ToString() method is not culture-sensitive.

ÉlémentItem DescriptionDescription
"-""-" Signe moins, qui indique un intervalle de temps négatif.A minus sign, which indicates a negative time interval. Aucun signe n’est inclus pour un intervalle de temps positif.No sign is included for a positive time span.
«d»"d" Nombre de jours dans l’intervalle de temps.The number of days in the time interval. Cet élément est omis si l’intervalle de temps est inférieur à un jour.This element is omitted if the time interval is less than one day.
«hh»"hh" Nombre d’heures dans l’intervalle de temps, entre 0 et 23.The number of hours in the time interval, ranging from 0 to 23.
«mm»"mm" Nombre de minutes dans l’intervalle de temps, entre 0 et 59.The number of minutes in the time interval, ranging from 0 to 59.
«SS»"ss" Nombre de secondes dans l’intervalle de temps, entre 0 et 59.The number of seconds in the time interval, ranging from 0 to 59.
"fffffff""fffffff" Fractions de seconde dans l’intervalle de temps.Fractional seconds in the time interval. Cet élément est omis si l’intervalle de temps n’inclut pas de fractions de seconde.This element is omitted if the time interval does not include fractional seconds. S’il est présent, les fractions de seconde sont toujours exprimées à l’aide de sept chiffres décimaux.If present, fractional seconds are always expressed using seven decimal digits.

Notes

Pour plus d’informations sur la comparaison de la représentation sous forme de chaîne de TimeSpan et de types de données Oracle, consultez l’article 324577 de la base de connaissances : System. TimeSpan ne correspond pas au type de données Interval Day to second d’Oracle 9i.For more information about comparing the string representation of TimeSpan and Oracle data types, see Knowledge Base article 324577: System.TimeSpan Does Not Match Oracle 9i INTERVAL DAY TO SECOND Data Type.

Notes pour les appelants

La prise en charge de la mise en forme des valeurs TimeSpan a été ajoutée dans le .NET Framework 4.NET Framework 4.Support for formatting TimeSpan values was added in the .NET Framework 4.NET Framework 4. Toutefois, la surcharge de méthode ToString() reste indépendante de la culture.However, the ToString() method overload remains culture-insensitive. Son comportement reste inchangé par rapport aux versions précédentes du .NET Framework.Its behavior remains unchanged from previous versions of the .NET Framework. Pour contrôler la mise en forme d’une valeur TimeSpan, appelez la surcharge ToString(String) ou ToString(String, IFormatProvider).To control the formatting of a TimeSpan value, call the ToString(String) or ToString(String, IFormatProvider) overload.

Voir aussi

S’applique à