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.TryParse (String, IFormatProvider, TimeSpan)

 

Publicado: octubre de 2016

Convierte la representación de cadena de un intervalo de tiempo en su equivalente de TimeSpan usando la información de formato específica de la referencia cultural, y devuelve un valor que indica si la conversión se realizó correctamente.

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

public static bool TryParse(
	string input,
	IFormatProvider formatProvider,
	out TimeSpan result
)

Parámetros

input
Type: System.String

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

formatProvider
Type: System.IFormatProvider

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

result
Type: System.TimeSpan

El resultado que devuelve este método contiene un objeto que representa el intervalo de tiempo especificado por input, o TimeSpan.Zero si la conversión no se realizó correctamente. Este parámetro se pasa sin inicializar.

Valor devuelto

Type: System.Boolean

true si input se convirtió correctamente; en caso contrario, false. Esta operación devuelve false si el parámetro input es null o String.Empty, tiene un formato no válido, representa un intervalo de tiempo menor que TimeSpan.MinValue o mayor que TimeSpan.MaxValue, o tiene al menos uno de sus componentes de días, horas, minutos o segundos fuera del intervalo válido.

El TryParse(String, IFormatProvider, TimeSpan) método es similar a la Parse(String, IFormatProvider) método, salvo que TI no produce una excepción si se produce un error en la conversión.

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

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

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

Elemento

Descripción

eb

Espacio en blanco opcional.

-

Un signo opcional, lo que indica un negativo TimeSpan.

d

Días, comprendidos entre 0 y 10675199.

.

Un símbolo de cuenta de la referencia cultural que separa los días de horas. El formato invariable usa un punto (".") .

hh

Horas, comprendido entre 0 y 23.

:

El símbolo de separador de hora de la cuenta 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 cuenta de la referencia cultural que separa los segundos de 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 input colectivamente se debe especificar un intervalo de tiempo es mayor o igual que TimeSpan.MinValue y menor o igual que TimeSpan.MaxValue.

El TryParse(String, IFormatProvider, TimeSpan) método intenta analizar input con cada uno de los formatos específicos de la referencia cultural para la referencia cultural especificada por formatProvider.

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.

Notas para llamadores:

En algunos casos, cuando un componente de intervalo de tiempo en la cadena para analizarse contiene más de siete dígitos, las operaciones que son correctas y devuelven de análisis true en el .NET Framework 3.5 y versiones anteriores pueden producir errores y devolver false en el .NET Framework 4, en el ejemplo siguiente se muestra este escenario.

string value = "000000006";
TimeSpan interval;
if (TimeSpan.TryParse(value, out interval))
   Console.WriteLine("{0} --> {1}", value, interval);
else
   Console.WriteLine("Unable to parse '{0}'", value);
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
// Output from .NET Framework 4:
//       Unable to parse //000000006//

En el ejemplo siguiente se define una matriz de CultureInfo objetos y cada objeto se utiliza en las llamadas a la TryParse(String, IFormatProvider, TimeSpan) método analizar los elementos en una matriz de cadenas. El ejemplo muestra cómo las convenciones de una referencia cultural concreta influyen en la operación de formato.

using System;
using System.Globalization;

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" };
      CultureInfo[] cultures = { new CultureInfo("en-US"), 
                                 new CultureInfo("ru-RU"),
                                 CultureInfo.InvariantCulture };

      string header = String.Format("{0,-17}", "String");
      foreach (CultureInfo culture in cultures)
         header += culture.Equals(CultureInfo.InvariantCulture) ? 
                      String.Format("{0,20}", "Invariant") :
                      String.Format("{0,20}", culture.Name);

      Console.WriteLine(header);
      Console.WriteLine();

      foreach (string value in values)
      {
         Console.Write("{0,-17}", value);
         foreach (CultureInfo culture in cultures)
         {
            TimeSpan interval = new TimeSpan();
            if (TimeSpan.TryParse(value, culture, out interval))
               Console.Write("{0,20}", interval.ToString("c"));
            else
               Console.Write("{0,20}", "Unable to Parse");
         }
         Console.WriteLine();                                
      }
   }
}
// The example displays the following output:
//    String                          en-US               ru-RU           Invariant
//    
//    6                          6.00:00:00          6.00:00:00          6.00:00:00
//    6:12                         06:12:00            06:12:00            06:12:00
//    6:12:14                      06:12:14            06: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                 6.12:14:45          6.12:14:45          6.12:14:45
//    6:12:14:45.3448    6.12:14:45.3448000     Unable to Parse  6.12:14:45.3448000
//    6:12:14:45,3448       Unable to Parse  6.12:14:45.3448000     Unable to Parse
//    6:34:14:45            Unable to Parse     Unable to Parse     Unable to Parse

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: