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 ()

 

Publicado: octubre de 2016

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

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

public override string ToString()

Valor devuelto

Type: System.String

Representación de cadena del valor TimeSpan actual.

La cadena devuelta tiene un formato con el especificador de formato "c" y tiene el formato siguiente:

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

Elementos entre corchetes ([y]) no pueden incluirse en la cadena devuelta. Dos puntos y puntos (: y.) son caracteres literales. Los elementos no literales se muestran en la tabla siguiente. Tenga en cuenta que la cadena devuelta por la ToString() método no tiene en cuenta la referencia cultural.

Elemento

Descripción

"-"

Un signo menos, que indica un intervalo de tiempo negativo. Ningún inicio de sesión se incluye como un intervalo de tiempo positivo.

"d"

El número de días en el intervalo de tiempo. Este elemento se omite si el intervalo de tiempo es inferior a un día.

"hh"

El número de horas en el intervalo de tiempo comprendido entre 0 y 23.

"mm"

El número de minutos en el intervalo de tiempo comprendido entre 0 y 59.

"ss"

El número de segundos en el intervalo de tiempo comprendido entre 0 y 59.

"fffffff"

Fracciones de segundo intervalo de tiempo. Este elemento se omite si el intervalo de tiempo no incluye fracciones de segundo. Si está presente, las fracciones de segundo siempre se expresan con siete dígitos decimales.

System_CAPS_noteNota

Para obtener más información sobre cómo comparar la representación de cadena de TimeSpan y tipos de datos de Oracle, vea el artículo de Knowledge Base 324577: System.TimeSpan Does Not Match Oracle 9i INTERVAL DAY TO SECOND Data Type.

Notas para llamadores:

Soporte técnico para dar formato a TimeSpan valores se agregó en el .NET Framework 4. Sin embargo, la ToString() sobrecarga del método es la referencia cultural. Su comportamiento varía desde versiones anteriores de .NET Framework. Para controlar el formato de un TimeSpan valor, llame a la ToString(String) o ToString(String, IFormatProvider) de sobrecarga.

En el ejemplo siguiente se muestra las cadenas devueltas por una llamada a la ToString método con un número de TimeSpan valores. Tenga en cuenta que aunque el ejemplo no llama a la ToString método directamente, se llama a la Console.WriteLine método cuando se intenta convertir un TimeSpan valor en su representación de cadena.

using System;

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

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