Metody System.TimeSpan.TryParse

Ten artykuł zawiera dodatkowe uwagi dotyczące dokumentacji referencyjnej dla tego interfejsu API.

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

Metoda TimeSpan.TryParse(String, TimeSpan) jest podobna do metody TimeSpan.Parse(String), z tą różnicą, że nie zgłasza wyjątku, jeśli konwersja się nie powiedzie.

Parametr s zawiera specyfikację interwału czasu w formularzu:

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

Elementy w nawiasach kwadratowych ([ i ]) są opcjonalne. Jeden wybór z listy alternatyw ujęty w nawiasy klamrowe ({ i }) i oddzielony kreskami pionowymi (|) jest wymagany. W tabeli poniżej opisano każdy element.

Składniki s muszą zbiorczo określać przedział czasu większy lub równy TimeSpan.MinValue i mniejszy lub równy TimeSpan.MaxValue.

Metoda Parse(String) próbuje przeanalizować s przy użyciu każdego z formatów specyficznych dla bieżącej kultury.

Metoda TryParse(String, IFormatProvider, TimeSpan)

Metoda TryParse(String, IFormatProvider, TimeSpan) jest podobna do metody Parse(String, IFormatProvider), z tą różnicą, że nie zgłasza wyjątku, jeśli konwersja się nie powiedzie.

Parametr input zawiera specyfikację interwału czasu w formularzu:

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

Elementy w nawiasach kwadratowych ([ i ]) są opcjonalne. Jeden wybór z listy alternatyw ujęty w nawiasy klamrowe ({ i }) i oddzielony kreskami pionowymi (|) jest wymagany. W tabeli poniżej opisano każdy element.

Składniki input muszą zbiorczo określać przedział czasu, który jest większy lub równy TimeSpan.MinValue i mniejszy niż lub równy TimeSpan.MaxValue.

Metoda TryParse(String, IFormatProvider, TimeSpan) próbuje przeanalizować input przy użyciu każdego ze specyficznych dla kultury formatów dla kultury określonej przez formatProvider.

Parametr formatProvider jest implementacją IFormatProvider , która dostarcza informacje specyficzne dla kultury dotyczące formatu zwracanego ciągu. Parametr formatProvider może być dowolny z następujących:

• CultureInfo Obiekt reprezentujący kulturę, której konwencje formatowania mają być odzwierciedlone w zwracanym ciągu. Obiekt DateTimeFormatInfo zwracany przez CultureInfo.DateTimeFormat właściwość definiuje formatowanie zwracanego ciągu.
• DateTimeFormatInfo Obiekt, który definiuje formatowanie zwracanego ciągu.
• Obiekt niestandardowy, który implementuje IFormatProvider interfejs. Metoda IFormatProvider.GetFormat zwraca DateTimeFormatInfo obiekt, który udostępnia informacje o formatowaniu.

Jeśli formatProvider jest null, to używany jest obiekt DateTimeFormatInfo skojarzony z bieżącą kulturą.

Uwagi do osób wywołujących

W niektórych przypadkach, gdy składnik interwału czasu w ciągu do przeanalizowania zawiera więcej niż siedem cyfr, operacje analizujące, które zakończyły się pomyślnie i zwracały true w programie .NET Framework 3.5 i wcześniejszych wersjach, mogą zakończyć się niepowodzeniem i zwrócić false w programie .NET Framework 4 i nowszych wersjach. Poniższy przykład ilustruje ten scenariusz:

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'