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, IFormatProvider)

 

Publicado: octubre de 2016

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.

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

public string ToString(
	string format,
	IFormatProvider formatProvider
)

Parámetros

format
Type: System.String

Cadena de formato de TimeSpan estándar o personalizado.

formatProvider
Type: System.IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Valor devuelto

Type: System.String

Representación de cadena del valor del objeto TimeSpan actual, con el formato especificado por format y formatProvider.

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 el formato es cualquier otro valor, el método produce una FormatException.

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:

El formatProvider parámetro es un IFormatProvider implementación que proporciona información específica de la referencia cultural acerca del formato de la cadena devuelta. El formatProvider parámetro puede ser cualquiera de las siguientes acciones:

Si formatProvider es null, el DateTimeFormatInfo se usa el objeto que está asociado a la referencia cultural actual. Si format es una cadena de formato personalizado, el formatProvider parámetro se ignora.

El ejemplo siguiente se llama el ToString(String, IFormatProvider) método para dar formato a dos intervalos de tiempo. En el ejemplo se llama al método dos veces para que las cadenas de formato, en primer lugar se mostrará con las convenciones de la referencia cultural en-US y, a continuación, se mostrará con las convenciones de la referencia cultural 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

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: