Metodi System.TimeSpan.TryParse

Questo articolo fornisce osservazioni supplementari alla documentazione di riferimento per questa API.

Metodo TryParse(System.String,System.TimeSpan@)

Il metodo TimeSpan.TryParse(String, TimeSpan) è simile al metodo TimeSpan.Parse(String), ad eccezione del fatto che non genera un'eccezione se la conversione non riesce.

Il parametro s contiene una specifica dell'intervallo di tempo nel formato :

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

Gli elementi tra parentesi quadre ([ e ]) sono facoltativi. È necessaria una selezione dall'elenco di alternative racchiuse tra parentesi graffe ({ e }) e separate da barre verticali (|). La tabella seguente descrive i singoli elementi.

Elemento	Descrizione
Ws	Spazio vuoto facoltativo.
-	Un segno meno opzionale, che indica un TimeSpannegativo.
d	Giorni, compresi tra 0 e 10675199.
.	Un simbolo sensibile alla cultura che separa i giorni dalle ore. Il formato invariante usa un carattere punto (".").
Hh	Ore, comprese tra 0 e 23.
:	Simbolo separatore temporale sensibile alla cultura. Il formato invariante usa il carattere due punti (":").
millimetro	Minuti, compresi tra 0 e 59.
ß	Secondi facoltativi, compresi tra 0 e 59.
.	Simbolo sensibile al contesto culturale che separa i secondi dalle frazioni di secondo. Il formato invariante usa un carattere punto (".").
Ff	Secondi frazionari facoltativi, costituiti da una a sette cifre decimali.

I componenti di s devono specificare collettivamente un intervallo di tempo maggiore o uguale a TimeSpan.MinValue e minore o uguale a TimeSpan.MaxValue.

Il metodo Parse(String) tenta di interpretare s utilizzando ciascuno dei formati specifici per le impostazioni culturali correnti.

Metodo TryParse(String, IFormatProvider, TimeSpan)

Il metodo TryParse(String, IFormatProvider, TimeSpan) è simile al metodo Parse(String, IFormatProvider), ad eccezione del fatto che non genera un'eccezione se la conversione non riesce.

Il parametro input contiene una specifica dell'intervallo di tempo nel formato :

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

Gli elementi tra parentesi quadre ([ e ]) sono facoltativi. È necessaria una selezione dall'elenco di alternative racchiuse tra parentesi graffe ({ e }) e separate da barre verticali (|). La tabella seguente descrive i singoli elementi.

Elemento	Descrizione
Ws	Spazio vuoto facoltativo.
-	Un segno meno opzionale, che indica un TimeSpannegativo.
d	Giorni, compresi tra 0 e 10675199.
.	Un simbolo sensibile alla cultura che separa i giorni dalle ore. Il formato invariante usa un carattere punto (".").
Hh	Ore, comprese tra 0 e 23.
:	Simbolo separatore temporale sensibile alla cultura. Il formato invariante usa il carattere due punti (":").
millimetro	Minuti, compresi tra 0 e 59.
ß	Secondi facoltativi, compresi tra 0 e 59.
.	Simbolo sensibile al contesto culturale che separa i secondi dalle frazioni di secondo. Il formato invariante usa un carattere punto (".").
Ff	Secondi frazionari facoltativi, costituiti da una a sette cifre decimali.

I componenti di input devono specificare collettivamente un intervallo di tempo maggiore o uguale a TimeSpan.MinValue e minore o uguale a TimeSpan.MaxValue.

Il metodo TryParse(String, IFormatProvider, TimeSpan) tenta di analizzare input usando ciascuno dei formati specifici delle impostazioni culturali per quella specificata da formatProvider.

Il parametro formatProvider è un'implementazione IFormatProvider che fornisce informazioni specifiche delle impostazioni culturali del formato della stringa restituita. Il parametro formatProvider può essere uno dei seguenti:

• Oggetto CultureInfo che rappresenta le impostazioni culturali di cui le convenzioni di formattazione devono riflettersi nella stringa restituita. L'oggetto DateTimeFormatInfo restituito dalla proprietà CultureInfo.DateTimeFormat definisce la formattazione della stringa restituita.
• Oggetto DateTimeFormatInfo che definisce la formattazione della stringa restituita.
• Oggetto personalizzato che implementa l'interfaccia IFormatProvider. Il metodo IFormatProvider.GetFormat restituisce un oggetto DateTimeFormatInfo che fornisce informazioni di formattazione.

Se formatProvider è null, viene utilizzato l'oggetto DateTimeFormatInfo associato alla cultura attuale.

Note per i chiamanti

In alcuni casi, quando un componente intervallo di tempo nella stringa da analizzare contiene più di sette cifre, le operazioni di analisi riuscite e restituite true in .NET Framework 3.5 e versioni precedenti potrebbero non riuscire e restituire false in .NET Framework 4 e versioni successive. L'esempio seguente illustra questo scenario:

string value = "000000006";
TimeSpan interval;
if (TimeSpan.TryParse(value, out interval))
   Console.WriteLine($"{value} --> {interval}");
else
   Console.WriteLine($"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//

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'