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.Parse (String)

 

Publicado: octubre de 2016

Convierte la representación de cadena de un intervalo de tiempo en su equivalente de TimeSpan.

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

public static TimeSpan Parse(
	string s
)

Parámetros

s
Type: System.String

Cadena que especifica el intervalo de tiempo que se va a convertir.

Valor devuelto

Type: System.TimeSpan

Intervalo de tiempo que corresponde a s.

Exception Condition
ArgumentNullException

El valor de s es null.

FormatException

s tiene un formato no válido.

OverflowException

s representa un número menor que TimeSpan.MinValue o mayor que TimeSpan.MaxValue.

O bien

Al menos uno de los componentes de días, horas, minutos o segundos está fuera del intervalo válido.

El s parámetro contiene una especificación de intervalo de tiempo en el formulario:

[ws][-]{ d | [d.]hh:mm[:ss[.ff]] }[ws]

Los elementos de los corchetes ([ y ]) son opcionales. Una selección de la lista de alternativas entre llaves ({y}) y separadas por barras verticales (|) son obligatorias. En la tabla siguiente describe cada elemento.

Elemento

Descripción

eb

Espacio en blanco opcional.

-

Un signo menos opcional, que indica un negativo TimeSpan.

d

Días, comprendidos entre 0 y 10675199.

.

Símbolo de la referencia cultural que separa horas a días. El formato invariable usa un punto (".") .

hh

Horas, comprendida entre 0 y 23.

:

El símbolo de separador de hora de la referencia cultural. El formato invariable usa dos puntos (":") caracteres.

mm

Minutos, comprendidos entre 0 y 59.

ss

Segundos opcionales, comprendidos entre 0 y 59.

.

Un símbolo de la referencia cultural que se separa los segundos de las fracciones de segundo. El formato invariable usa un punto (".") .

ff

Fracciones de segundo opcionales, que consta de uno a siete dígitos decimales.

Los componentes de s colectivamente se debe especificar un intervalo de tiempo es mayor o igual a TimeSpan.MinValue y menor o igual que TimeSpan.MaxValue.

El Parse(String) método intenta analizar s con cada uno de los formatos específicos de la referencia cultural para la referencia cultural actual.

Notas para llamadores:

Cuando un componente de intervalo de tiempo en la cadena que se va a analizar contiene más de siete dígitos, análisis de las operaciones en el .NET Framework 3.5 y versiones anteriores pueden comportarse de manera diferente del análisis de las operaciones en el .NET Framework 4. En algunos casos, análisis de las operaciones que se realizan correctamente en el .NET Framework 3.5 y versiones anteriores pueden producir errores y producir un OverflowException en la .NET Framework 4. En otros casos, análisis de las operaciones que producen un FormatException en el .NET Framework 3.5 y versiones anteriores pueden producir errores y producir un OverflowException en la .NET Framework 4. En el ejemplo siguiente se ilustra ambos escenarios.

string[] values = { "000000006", "12.12:12:12.12345678" };
foreach (string value in values)
{
   try {
      TimeSpan interval = TimeSpan.Parse(value);
      Console.WriteLine("{0} --> {1}", value, interval);
   }   
   catch (FormatException) {
      Console.WriteLine("{0}: Bad Format", value);
   }   
   catch (OverflowException) {
      Console.WriteLine("{0}: Overflow", value);
   }
}
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
//       12.12:12:12.12345678: Bad Format      
// Output from .NET Framework 4:
//       000000006: Overflow
//       12.12:12:12.12345678: Overflow

En el ejemplo siguiente se usa el Parse método para convertir cada elemento de una matriz de cadenas a un TimeSpan valor. Cambia la referencia cultural del sistema actual a Croata - Croacia ("hr-HR") e inglés - Estados Unidos ("en-US") para mostrar cómo la referencia cultural del sistema actual afecta a la operación de análisis.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      string[] values = { "6", "6:12", "6:12:14", "6:12:14:45", 
                          "6.12:14:45", "6:12:14:45.3448", 
                          "6:12:14:45,3448", "6:34:14:45" };
      string[] cultureNames = { "hr-HR", "en-US"};

      // Change the current culture.
      foreach (string cultureName in cultureNames)
      {
         Thread.CurrentThread.CurrentCulture = new CultureInfo(cultureName);
         Console.WriteLine("Current Culture: {0}", 
                           Thread.CurrentThread.CurrentCulture.Name);
         foreach (string value in values)
         {
            try {
               TimeSpan ts = TimeSpan.Parse(value);
               Console.WriteLine("{0} --> {1}", value, ts.ToString("c"));
            }
            catch (FormatException) {
               Console.WriteLine("{0}: Bad Format", value);
            }   
            catch (OverflowException) {
               Console.WriteLine("{0}: Overflow", value);
            }
         } 
         Console.WriteLine();                                
      }
   }
}
// The example displays the following output:
//    Current Culture: hr-HR
//    6 --> 6.00:00:00
//    6:12 --> 06:12:00
//    6:12:14 --> 06:12:14
//    6:12:14:45 --> 6.12:14:45
//    6.12:14:45 --> 6.12:14:45
//    6:12:14:45.3448: Bad Format
//    6:12:14:45,3448 --> 6.12:14:45.3448000
//    6:34:14:45: Overflow
//    
//    Current Culture: en-US
//    6 --> 6.00:00:00
//    6:12 --> 06:12:00
//    6:12:14 --> 06:12:14
//    6:12:14:45 --> 6.12:14:45
//    6.12:14:45 --> 6.12:14:45
//    6:12:14:45.3448 --> 6.12:14:45.3448000
//    6:12:14:45,3448: Bad Format
//    6:34:14:45: Overflow

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: