TimeSpan.ToString TimeSpan.ToString TimeSpan.ToString TimeSpan.ToString Method

Definição

Converte o valor do atual objeto TimeSpan na representação de cadeia de caracteres equivalente.Converts the value of the current TimeSpan object to its equivalent string representation.

Sobrecargas

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Converte o valor do objeto TimeSpan atual na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formatação específicas da cultura.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) ToString(String) ToString(String) ToString(String)

Converte o valor do objeto TimeSpan atual para sua representação de cadeia de caracteres equivalente usando o formato especificado.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format.

ToString() ToString() ToString() ToString()

Converte o valor do atual objeto TimeSpan na representação de cadeia de caracteres equivalente.Converts the value of the current TimeSpan object to its equivalent string representation.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Converte o valor do objeto TimeSpan atual na representação de cadeia de caracteres equivalente usando o formato especificado e as informações de formatação específicas da cultura.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

Parâmetros

format
String String String String

Uma cadeia de caracteres de formato TimeSpan personalizada ou padrão.A standard or custom TimeSpan format string.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Um objeto que fornece informações de formatação específicas de cultura.An object that supplies culture-specific formatting information.

Retornos

Uma representação de cadeia de caracteres do valor TimeSpan atual, conforme especificado por format e formatProvider.The string representation of the current TimeSpan value, as specified by format and formatProvider.

Implementações

Exceções

O parâmetro format não é reconhecido ou não tem suporte.The format parameter is not recognized or is not supported.

Exemplos

O exemplo a seguir chama ToString(String, IFormatProvider) o método para formatar dois intervalos de tempo.The following example calls the ToString(String, IFormatProvider) method to format two time intervals. O exemplo chama o método duas vezes para cada cadeia de caracteres de formato, primeiro para exibi-lo usando as convenções da cultura en-US e, em seguida, exibi-lo usando as convenções da cultura 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

Comentários

O format parâmetro pode ser qualquer especificador de formato padrão ou personalizado TimeSpan válido para valores.The format parameter can be any valid standard or custom format specifier for TimeSpan values. Se format for igual a String.Empty ou for null, o valor de retorno do objeto TimeSpan atual será formatado com o especificador de formato comum ("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"). Se o formato for qualquer outro valor, o método lançará um FormatException.If format is any other value, the method throws a FormatException.

Importante

As cadeias de caracteres TimeSpan de formato personalizado para valores não incluem um separador de data ou hora.The custom format strings for TimeSpan values do not include a date or time separator. Se você quiser incluir esses elementos em sua cadeia de caracteres de formato, você deve tratá-los como literais de caracteres.If you want to include these elements in your format string, you must treat them as character literals. Consulte o exemplo de uma ilustração e veja o tópico Strings de formato de TimeSpan personalizado para obter mais informações.See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

O .NET Framework fornece extenso suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

O formatProvider parâmetro é uma IFormatProvider implementação que fornece informações específicas de cultura sobre o formato da cadeia de caracteres retornada.The formatProvider parameter is an IFormatProvider implementation that provides culture-specific information about the format of the returned string. O parâmetro formatProvider pode ser um dos seguintes:The formatProvider parameter can be any of the following:

Caso formatProvider seja null, o objeto DateTimeFormatInfo que está associado à cultura atual é usado.If formatProvider is null, the DateTimeFormatInfo object that is associated with the current culture is used. Se format for uma cadeia de caracteres de formato formatProvider personalizado, o parâmetro será ignorado.If format is a custom format string, the formatProvider parameter is ignored.

Veja também

ToString(String) ToString(String) ToString(String) ToString(String)

Converte o valor do objeto TimeSpan atual para sua representação de cadeia de caracteres equivalente usando o formato especificado.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

Parâmetros

format
String String String String

Uma cadeia de caracteres de formato TimeSpan personalizada ou padrão.A standard or custom TimeSpan format string.

Retornos

A representação de cadeia de caracteres do valor TimeSpan atual no formato especificado pelo parâmetro format.The string representation of the current TimeSpan value in the format specified by the format parameter.

Exceções

O parâmetro format não é reconhecido ou não tem suporte.The format parameter is not recognized or is not supported.

Exemplos

O exemplo a seguir usa cadeias TimeSpan de formato padrão e personalizadas para exibir a representação de cadeia de caracteres de TimeSpan cada elemento em uma matriz de valoresThe 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.

Comentários

O format parâmetro pode ser qualquer especificador de formato padrão ou personalizado TimeSpan válido para valores.The format parameter can be any valid standard or custom format specifier for TimeSpan values. Se format for igual a String.Empty ou for null, o valor de retorno do objeto TimeSpan atual será formatado com o especificador de formato comum ("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"). Caso format tenha qualquer outro valor, o método lança um FormatException.If format is any other value, the method throws a FormatException.

Se format é uma cadeia de caracteres de formato padrão, o formato da cadeia de caracteres retornada é definido pelas convenções de formatação da cultura atual.If format is a standard format string, the format of the returned string is defined by the formatting conventions of the current culture.

Importante

As cadeias de caracteres TimeSpan de formato personalizado para valores não incluem um separador de data ou hora.The custom format strings for TimeSpan values do not include a date or time separator. Se você quiser incluir esses elementos em sua cadeia de caracteres de formato, você deve tratá-los como literais de caracteres.If you want to include these elements in your format string, you must treat them as character literals. Consulte o exemplo de uma ilustração e veja o tópico Strings de formato de TimeSpan personalizado para obter mais informações.See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

O .NET Framework fornece extenso suporte à formatação, que é descrito com mais detalhes nos seguintes tópicos de formatação:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Veja também

ToString() ToString() ToString() ToString()

Converte o valor do atual objeto TimeSpan na representação de cadeia de caracteres equivalente.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

Retornos

Uma representação de cadeia de caracteres do valor TimeSpan atual.The string representation of the current TimeSpan value.

Exemplos

O exemplo a seguir exibe as cadeias de caracteres ToString retornadas chamando o método TimeSpan com um número de valores.The following example displays the strings returned by calling the ToString method with a number of TimeSpan values. Observe que, embora o exemplo não chame o ToString método diretamente, ele é chamado Console.WriteLine pelo método quando tenta converter um TimeSpan valor em sua representação de cadeia de caracteres.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

Comentários

A cadeia de caracteres retornada é formatada com o especificador de formato "c" e tem o seguinte formato: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]

Os elementos entre colchetes ([e]) não podem ser incluídos na cadeia de caracteres retornada.Elements in square brackets ([ and ]) may not be included in the returned string. Dois pontos e pontos (: e.) são caracteres literais.Colons and periods (: and.) are literal characters. Os elementos não literais são listados na tabela a seguir.The non-literal elements are listed in the following table. Observe que a cadeia de caracteres retornada ToString() pelo método não é sensível à cultura.Note that the string returned by the ToString() method is not culture-sensitive.

ItemItem DescriçãoDescription
"-""-" Um sinal de subtração, que indica um intervalo de tempo negativo.A minus sign, which indicates a negative time interval. Nenhum sinal está incluído por um período positivo.No sign is included for a positive time span.
"d""d" O número de dias no intervalo de tempo.The number of days in the time interval. Esse elemento será omitido se o intervalo de tempo for menor que um dia.This element is omitted if the time interval is less than one day.
"hh""hh" O número de horas no intervalo de tempo, variando de 0 a 23.The number of hours in the time interval, ranging from 0 to 23.
"mm""mm" O número de minutos no intervalo de tempo, variando de 0 a 59.The number of minutes in the time interval, ranging from 0 to 59.
"ss""ss" O número de segundos no intervalo de tempo, variando de 0 a 59.The number of seconds in the time interval, ranging from 0 to 59.
"fffffff""fffffff" Fração de segundo no intervalo de tempo.Fractional seconds in the time interval. Esse elemento será omitido se o intervalo de tempo não incluir segundos fracionários.This element is omitted if the time interval does not include fractional seconds. Se houver, os segundos fracionários serão sempre expressos usando sete dígitos decimais.If present, fractional seconds are always expressed using seven decimal digits.

Observação

Para obter mais informações sobre como comparar a representação TimeSpan de cadeia de caracteres dos tipos de dados do e do Oracle, consulte o artigo 324577 da base de conhecimento: System. TimeSpan não corresponde ao tipode dados do dia de intervalo do Oracle 9i para o segundo.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.

Notas aos Chamadores

TimeSpan O.NET Framework 4.NET Framework 4suporte para valores de formatação foi adicionado no.Support for formatting TimeSpan values was added in the .NET Framework 4.NET Framework 4. No entanto ToString() , a sobrecarga do método permanece sem diferenciação de cultura.However, the ToString() method overload remains culture-insensitive. Seu comportamento permanece inalterado de versões anteriores do .NET Framework.Its behavior remains unchanged from previous versions of the .NET Framework. Para controlar a formatação de um TimeSpan valor, chame a ToString(String) sobrecarga ToString(String, IFormatProvider) ou.To control the formatting of a TimeSpan value, call the ToString(String) or ToString(String, IFormatProvider) overload.

Veja também

Aplica-se a