Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método TimeSpan.ToString (String)

 

Publicado: octubre de 2016

Convierte el valor del objeto TimeSpan actual en su representación de cadena equivalente usando el formato especificado.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public string ToString(
	string format
)

Parámetros

format
Type: System.String

Cadena de formato de TimeSpan estándar o personalizado.

Valor devuelto

Type: System.String

Representación de cadena del valor TimeSpan actual en el formato especificado por el parámetro format.

Exception Condition
FormatException

El parámetro format no se reconoce o no es compatible.

El format parámetro puede ser cualquier especificador de formato estándar o personalizado válido para TimeSpan valores. Si format es igual a String.Empty o null, el valor devuelto de la actual TimeSpan objeto está formateado con el especificador de formato comunes ("c"). Si format es cualquier otro valor, el método produce una FormatException.

Si format es una cadena de formato estándar, se define el formato de la cadena devuelta por las convenciones de formato de la referencia cultural actual.

System_CAPS_importantImportante

Las cadenas de formato personalizado para TimeSpan valores no incluyen un separador de fecha u hora. Si desea incluir estos elementos en la cadena de formato, debe tratarlos como literales de carácter. Vea el ejemplo para ver una ilustración y vea el Cadenas de formato TimeSpan personalizado tema para obtener más información.

.NET Framework proporciona una amplia compatibilidad de formato, que se describe con más detalle en los temas de formato siguientes:

En el ejemplo siguiente se usa estándar y personalizado TimeSpan dar formato a las cadenas para mostrar la representación de cadena de cada elemento en una matriz de TimeSpan valores

using System;

public class Class1
{
   public static void Main()
   {
      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.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 4.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 4.0
Windows Phone Silverlight
Disponible desde 7.1
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: