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

Definición

Convierte el valor del objeto TimeSpan actual en su representación de cadena 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)

Convierte el valor del objeto TimeSpan actual en la representación de cadena equivalente usando el formato especificado y la información de formato específica de la referencia cultural.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)

Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente usando el formato especificado.Converts the value of the current TimeSpan object to its equivalent string representation by using the specified format.

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

Convierte el valor del objeto TimeSpan actual en su representación de cadena 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)

Convierte el valor del objeto TimeSpan actual en la representación de cadena equivalente usando el formato especificado y la información de formato específica de la referencia cultural.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

Cadena de formato de TimeSpan estándar o personalizado.A standard or custom TimeSpan format string.

formatProvider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

Representación de cadena del valor del objeto TimeSpan actual, con el formato especificado por format y formatProvider.The string representation of the current TimeSpan value, as specified by format and formatProvider.

Implementaciones

Excepciones

El parámetro format no se reconoce o no es compatible.The format parameter is not recognized or is not supported.

Ejemplos

En el ejemplo siguiente se ToString(String, IFormatProvider) llama al método para dar formato a dos intervalos de tiempo.The following example calls the ToString(String, IFormatProvider) method to format two time intervals. En el ejemplo se llama al método dos veces para cada cadena de formato, primero para mostrarla mediante las convenciones de la referencia cultural en-US y, a continuación, para mostrarla mediante las convenciones de la referencia cultural 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

Comentarios

El format parámetro puede ser cualquier especificador de formato estándar o personalizado válido TimeSpan para los valores.The format parameter can be any valid standard or custom format specifier for TimeSpan values. Si format es igual a String.Empty o es null, el valor devuelto del objeto TimeSpan actual se formatea con el especificador de formato común ("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 es cualquier otro valor, el método produce una FormatExceptionexcepción.If format is any other value, the method throws a FormatException.

Importante

Las cadenas de formato personalizado TimeSpan para los valores no incluyen un separador de fecha u hora.The custom format strings for TimeSpan values do not include a date or time separator. Si desea incluir estos elementos en la cadena de formato, debe tratarlos como literales de carácter.If you want to include these elements in your format string, you must treat them as character literals. Vea el ejemplo de una ilustración y vea el tema cadenas de formato TimeSpan personalizado para obtener más información.See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

El .NET Framework proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

El formatProvider parámetro es una IFormatProvider implementación de que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta.The formatProvider parameter is an IFormatProvider implementation that provides culture-specific information about the format of the returned string. El formatProvider parámetro puede ser cualquiera de los siguientes:The formatProvider parameter can be any of the following:

Si formatProvider DateTimeFormatInfo es null, se utiliza el objeto asociado a la referencia cultural actual.If formatProvider is null, the DateTimeFormatInfo object that is associated with the current culture is used. Si format es una cadena de formato personalizado, formatProvider se omite el parámetro.If format is a custom format string, the formatProvider parameter is ignored.

Consulte también:

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

Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente usando el 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

Cadena de formato de TimeSpan estándar o personalizado.A standard or custom TimeSpan format string.

Devoluciones

Representación de cadena del valor TimeSpan actual en el formato especificado por el parámetro format.The string representation of the current TimeSpan value in the format specified by the format parameter.

Excepciones

El parámetro format no se reconoce o no es compatible.The format parameter is not recognized or is not supported.

Ejemplos

En el ejemplo siguiente se usan cadenas TimeSpan de formato estándar y personalizado para mostrar la representación de cadena de cada elemento TimeSpan en una matriz de valores.The 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.

Comentarios

El format parámetro puede ser cualquier especificador de formato estándar o personalizado válido TimeSpan para los valores.The format parameter can be any valid standard or custom format specifier for TimeSpan values. Si format es igual a String.Empty o es null, el valor devuelto del objeto TimeSpan actual se formatea con el especificador de formato común ("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 es cualquier otro valor, el método produce una FormatExceptionexcepción.If format is any other value, the method throws a FormatException.

Si format es una cadena de formato estándar, el formato de la cadena devuelta se define mediante las convenciones de formato de la referencia cultural actual.If format is a standard format string, the format of the returned string is defined by the formatting conventions of the current culture.

Importante

Las cadenas de formato personalizado TimeSpan para los valores no incluyen un separador de fecha u hora.The custom format strings for TimeSpan values do not include a date or time separator. Si desea incluir estos elementos en la cadena de formato, debe tratarlos como literales de carácter.If you want to include these elements in your format string, you must treat them as character literals. Vea el ejemplo de una ilustración y vea el tema cadenas de formato TimeSpan personalizado para obtener más información.See the example for an illustration, and see the Custom TimeSpan Format Strings topic for more information.

El .NET Framework proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Consulte también:

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

Convierte el valor del objeto TimeSpan actual en su representación de cadena 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

Devoluciones

Representación de cadena del valor TimeSpan actual.The string representation of the current TimeSpan value.

Ejemplos

En el ejemplo siguiente se muestran las cadenas devueltas ToString llamando al método con TimeSpan varios valores.The following example displays the strings returned by calling the ToString method with a number of TimeSpan values. Tenga en cuenta que, aunque en el ejemplo ToString no se llama al método directamente, el Console.WriteLine método lo llama cuando intenta convertir un TimeSpan valor en su representación de cadena.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

Comentarios

La cadena devuelta tiene el formato del especificador de formato "c" y tiene el siguiente 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]

Los elementos entre corchetes ([y]) no se pueden incluir en la cadena devuelta.Elements in square brackets ([ and ]) may not be included in the returned string. Los dos puntos y los puntos (: y.) son caracteres literales.Colons and periods (: and.) are literal characters. Los elementos no literales se muestran en la tabla siguiente.The non-literal elements are listed in the following table. Observe que la cadena devuelta por ToString() el método no tiene en cuenta la referencia cultural.Note that the string returned by the ToString() method is not culture-sensitive.

ElementoItem DescripciónDescription
"-""-" Signo menos, que indica un intervalo de tiempo negativo.A minus sign, which indicates a negative time interval. No se incluye ningún signo para un intervalo de tiempo positivo.No sign is included for a positive time span.
"d""d" Número de días del intervalo de tiempo.The number of days in the time interval. Este elemento se omite si el intervalo de tiempo es inferior a un día.This element is omitted if the time interval is less than one day.
"HH""hh" El número de horas en el intervalo de tiempo, comprendido entre 0 y 23.The number of hours in the time interval, ranging from 0 to 23.
"mm""mm" El número de minutos en el intervalo de tiempo, comprendido entre 0 y 59.The number of minutes in the time interval, ranging from 0 to 59.
"SS""ss" El número de segundos en el intervalo de tiempo, comprendido entre 0 y 59.The number of seconds in the time interval, ranging from 0 to 59.
"FFFFFFF""fffffff" Fracciones de segundo en el intervalo de tiempo.Fractional seconds in the time interval. Este elemento se omite si el intervalo de tiempo no incluye las fracciones de segundo.This element is omitted if the time interval does not include fractional seconds. Si está presente, las fracciones de segundo se expresan siempre con siete dígitos decimales.If present, fractional seconds are always expressed using seven decimal digits.

Nota

Para obtener más información acerca de la comparación de la TimeSpan representación de cadena de y los tipos de datos de Oracle, vea el artículo 324577 de Knowledge Base: System. TimeSpan no coincide con el tipode datos Day de Oracle 9i Interval.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 a los autores de las llamadas

Se ha agregado TimeSpan compatibilidad con valores de formato .NET Framework 4.NET Framework 4en.Support for formatting TimeSpan values was added in the .NET Framework 4.NET Framework 4. Sin embargo, ToString() la sobrecarga del método sigue siendo dependiente de la referencia cultural.However, the ToString() method overload remains culture-insensitive. Su comportamiento permanece sin cambios respecto a las versiones anteriores del .NET Framework.Its behavior remains unchanged from previous versions of the .NET Framework. Para controlar el formato de un TimeSpan valor, llame a ToString(String) la ToString(String, IFormatProvider) sobrecarga o.To control the formatting of a TimeSpan value, call the ToString(String) or ToString(String, IFormatProvider) overload.

Consulte también:

Se aplica a