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.TryParseExact (String, String[], IFormatProvider, TimeSpan)

 

Publicado: octubre de 2016

Convierte la representación de cadena especificada de un intervalo de tiempo en su equivalente de TimeSpan usando los formatos especificados y la información de formato específica de la referencia cultural, y devuelve un valor que indica si la conversión se realizó correctamente. El formato de la representación de cadena debe coincidir exactamente con uno de los formatos especificados.

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

public static bool TryParseExact(
	string input,
	string[] formats,
	IFormatProvider formatProvider,
	out TimeSpan result
)

Parámetros

input
Type: System.String

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

formats
Type: System.String[]

Matriz de cadenas de formato estándar o personalizado que definen los formatos aceptables de input.

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.

El TryParseExact(String, String[], IFormatProvider, TimeSpan) método analiza la representación de cadena de un intervalo de tiempo que debe estar en el formato definido por una de las cadenas de formato especificadas por la formats parámetro, excepto los caracteres de espacio en blanco que iniciales y finales se omiten. Este método es similar a la ParseExact(String, String[], IFormatProvider) (método), salvo que TI no produce una excepción si se produce un error en la conversión.

El formats parámetro es una matriz de cadena cuyos elementos constan de un especificador de formato estándar único o uno o varios especificadores de formato personalizado que definen el formato requerido de input. Para obtener más información acerca de las cadenas de formato válidos, vea Cadenas de formato TimeSpan estándar y Cadenas de formato TimeSpan personalizado. input debe corresponder exactamente a un miembro de formats para la operación de análisis se realice correctamente. La operación de análisis que se intenta hacer coincidir input a cada elemento de formats empezando por el primer elemento de la matriz.

System_CAPS_importantImportante

El TryParseExact método usa las convenciones de la referencia cultural especificada por el formatProvider parámetro solo si la cadena de formato que se usa para analizar input es un estándar TimeSpan formato de cadena cuyo valor es "g" o "G". Las cadenas de formato estándar "T", "c" y "t" usan las convenciones de formato de la referencia cultural invariable. Cadenas de formato personalizado definen el formato exacto de la cadena de entrada y utilice caracteres literales para separar los componentes de un intervalo de tiempo.

El formatProvider parámetro es un IFormatProvider implementación que proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta si la cadena de formato que se usa para analizar input es una cadena de formato estándar. El formatProvider parámetro puede ser cualquiera de los siguientes:

Si formatProvider es null, el DateTimeFormatInfo se usa el objeto que está asociado a la referencia cultural actual.

El ejemplo siguiente se llama el TryParseExact(String, String[], IFormatProvider, TimeSpan) método para convertir cada elemento de una matriz de cadenas a un TimeSpan valor. En el ejemplo se interpreta las cadenas usando las convenciones de formato de la referencia cultural de Francia ("fr-FR") de francés. Las cadenas pueden representar un intervalo de tiempo en el formato corto general o en el formato largo general.

Además, el ejemplo cambia la manera en que los métodos de análisis de intervalo de tiempo interpretan un único dígito. Normalmente, un solo dígito se interpreta como el número de días en un intervalo de tiempo. En su lugar, el %h cadena de formato personalizado se usa para interpretar un dígito único como el número de horas. Para que este cambio sea efectivo, tenga en cuenta que el %h cadena de formato personalizado debe preceder a las otras cadenas de formato en el formats matriz.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] inputs = { "3", "16:42", "1:6:52:35.0625", 
                          "1:6:52:35,0625" }; 
      string[] formats = { "g", "G", "%h"};
      TimeSpan interval;
      CultureInfo culture = new CultureInfo("fr-FR");

      // Parse each string in inputs using formats and the fr-FR culture.
      foreach (string input in inputs) {
         if(TimeSpan.TryParseExact(input, formats, culture, out interval))
            Console.WriteLine("{0} --> {1:c}", input, interval);
         else
            Console.WriteLine("Unable to parse {0}", input);   
      }
   }
}
// The example displays the following output:
//       3 --> 03:00:00
//       16:42 --> 16:42:00
//       Unable to parse 1:6:52:35.0625
//       1:6:52:35,0625 --> 1.06:52:35.0625000

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: