Métodos System.TimeSpan.TryParse

Este artigo fornece observações complementares à documentação de referência para essa API.

Método TryParse(System.String,System.TimeSpan@)

O TimeSpan.TryParse(String, TimeSpan) método é como o TimeSpan.Parse(String) método, exceto que ele não lança uma exceção se a conversão falhar.

O s parâmetro contém uma especificação de intervalo de tempo no formato:

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

Os elementos entre colchetes ([ e ]) são opcionais. É necessária uma seleção da lista de alternativas entre chaves ({ e }) e separadas por barras verticais (|). A tabela a seguir descreve cada elemento.

Element	Descrição
ws	Espaço em branco opcional.
-	Um sinal de subtração opcional, que indica um TimeSpan negativo.
d	Dias, variando de 0 a 10675199.
.	Um símbolo sensível à cultura que separa dias de horas. O formato invariável usa um caractere de ponto final (".").
hh	Horas, variando de 0 a 23.
:	O símbolo separador de hora sensível à cultura. O formato invariante usa um caractere de dois pontos (":").
mm	Minutos, variando de 0 a 59.
ss	Segundos opcionais, variando de 0 a 59.
.	Um símbolo sensível à cultura que separa segundos de frações de um segundo. O formato invariável usa um caractere de ponto final (".").
ff	Segundos fracionários opcionais, consistindo em um a sete dígitos decimais.

Os componentes do devem especificar coletivamente um intervalo de s tempo maior ou igual a e menor ou igual a TimeSpan.MinValueTimeSpan.MaxValue.

O Parse(String) método tenta analisar s usando cada um dos formatos específicos de cultura para a cultura atual.

Método TryParse(String, IFormatProvider, TimeSpan)

O TryParse(String, IFormatProvider, TimeSpan) método é como o Parse(String, IFormatProvider) método, exceto que ele não lança uma exceção se a conversão falhar.

O input parâmetro contém uma especificação de intervalo de tempo no formato:

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

Os elementos entre colchetes ([ e ]) são opcionais. É necessária uma seleção da lista de alternativas entre chaves ({ e }) e separadas por barras verticais (|). A tabela a seguir descreve cada elemento.

Element	Descrição
ws	Espaço em branco opcional.
-	Um sinal de subtração opcional, que indica um TimeSpan negativo.
d	Dias, variando de 0 a 10675199.
.	Um símbolo sensível à cultura que separa dias de horas. O formato invariável usa um caractere de ponto final (".").
hh	Horas, variando de 0 a 23.
:	O símbolo separador de hora sensível à cultura. O formato invariante usa um caractere de dois pontos (":").
mm	Minutos, variando de 0 a 59.
ss	Segundos opcionais, variando de 0 a 59.
.	Um símbolo sensível à cultura que separa segundos de frações de um segundo. O formato invariável usa um caractere de ponto final (".").
ff	Segundos fracionários opcionais, consistindo em um a sete dígitos decimais.

Os componentes do devem especificar coletivamente um intervalo de input tempo maior ou igual a e menor ou igual a TimeSpan.MinValueTimeSpan.MaxValue.

O TryParse(String, IFormatProvider, TimeSpan) método tenta analisar input usando cada um dos formatos específicos de cultura para a cultura especificada por formatProvider.

O formatProvider parâmetro é uma IFormatProvider implementação que fornece informações específicas da cultura sobre o formato da cadeia de caracteres retornada. O parâmetro formatProvider pode ser um dos seguintes:

• Um objeto CultureInfo que representa a cultura cujas convenções de formatação devem ser refletidas na cadeia de caracteres retornada. O objeto DateTimeFormatInfo retornado pela propriedade CultureInfo.DateTimeFormat define a formatação da cadeia de caracteres retornada.
• Um objeto DateTimeFormatInfo que define a formatação da cadeia de caracteres retornada.
• Um objeto personalizado que implementa a interface IFormatProvider. O método IFormatProvider.GetFormat retorna um objeto DateTimeFormatInfo que fornece informações de formatação.

Caso formatProvider seja null, o objeto DateTimeFormatInfo que está associado à cultura atual é usado.

Notas aos chamadores

Em alguns casos, quando um componente de intervalo de tempo na cadeia de caracteres a ser analisada contém mais de sete dígitos, as operações de análise bem-sucedidas e retornadas true no .NET Framework 3.5 e versões anteriores podem falhar e retornar false no .NET Framework 4 e versões posteriores. O exemplo a seguir ilustra esse cenário:

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//

let value = "000000006"
match TimeSpan.TryParse value with
| true, interval ->
    printfn $"{value} --> {interval}"
| _ ->
    printfn $"Unable to parse '{value}'"
    
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
// Output from .NET Framework 4:
//       Unable to parse //000000006//

Dim value As String = "000000006"
Dim interval As TimeSpan
If TimeSpan.TryParse(value, interval) Then
   Console.WriteLine("{0} --> {1}", value, interval)
Else
   Console.WriteLine("Unable to parse '{0}'", value)
End If
' Output from .NET Framework 3.5 and earlier versions:
'       000000006 --> 6.00:00:00
' Output from .NET Framework 4:
'       Unable to parse '000000006'