Aracılığıyla paylaş

System.TimeSpan.TryParse yöntemleri

  • Makale

Bu makale, bu API'nin başvuru belgelerine ek açıklamalar sağlar.

TryParse(System.String,System.TimeSpan@) yöntemi

TimeSpan.TryParse(String, TimeSpan) yöntemi yöntemine TimeSpan.Parse(String) benzer, ancak dönüştürme başarısız olursa bir özel durum oluşturmaz.

s parametresi, formda bir zaman aralığı belirtimi içerir:

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

Köşeli ayraçlar ([ve]) içindeki öğeler isteğe bağlıdır. Küme ayracı ({ ve }) içine alınmış ve dikey çubuklarla (|) ayrılmış alternatifler listesinden bir seçim yapılması gerekir. Aşağıdaki tablo her öğeyi açıklar.

Öğe Açıklama
Ws İsteğe bağlı beyaz boşluk.
- Negatif olduğunu gösteren isteğe bağlı eksi TimeSpanişareti.
d 0 ile 10675199 arasında değişen gün.
. Günleri saatlerden ayıran kültüre duyarlı bir simge. Sabit biçim bir nokta (".") karakteri kullanır.
hh 0-23 arasında saat.
: Kültüre duyarlı saat ayırıcı simgesi. Sabit biçim iki nokta üst üste (":") karakteri kullanır.
mm 0 ile 59 arasında dakika.
ss 0 İle 59 arasında değişen isteğe bağlı saniye.
. Saniyeleri saniye parçalarından ayıran bir kültüre duyarlı simge. Sabit biçim bir nokta (".") karakteri kullanır.
ff Bir ila yedi ondalık basamaktan oluşan isteğe bağlı saniye parçası.

bileşenlerinin s , değerine eşit TimeSpan.MinValue veya ondan büyük ve değerinden küçük veya eşit bir zaman aralığını toplu olarak belirtmesi TimeSpan.MaxValuegerekir.

yöntemi, Parse(String) geçerli kültür için kültüre özgü biçimlerin her birini kullanarak ayrıştırmaya s çalışır.

TryParse(String, IFormatProvider, TimeSpan) Yöntem

yöntemi TryParse(String, IFormatProvider, TimeSpan) yöntemine Parse(String, IFormatProvider) benzer, ancak dönüştürme başarısız olursa bir özel durum oluşturmaz.

input parametresi, formda bir zaman aralığı belirtimi içerir:

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

Köşeli ayraçlar ([ve]) içindeki öğeler isteğe bağlıdır. Küme ayracı ({ ve }) içine alınmış ve dikey çubuklarla (|) ayrılmış alternatifler listesinden bir seçim yapılması gerekir. Aşağıdaki tablo her öğeyi açıklar.

Öğe Açıklama
Ws İsteğe bağlı beyaz boşluk.
- Negatif olduğunu gösteren isteğe bağlı eksi TimeSpanişareti.
d 0 ile 10675199 arasında değişen gün.
. Günleri saatlerden ayıran kültüre duyarlı bir simge. Sabit biçim bir nokta (".") karakteri kullanır.
hh 0-23 arasında saat.
: Kültüre duyarlı saat ayırıcı simgesi. Sabit biçim iki nokta üst üste (":") karakteri kullanır.
mm 0 ile 59 arasında dakika.
ss 0 İle 59 arasında değişen isteğe bağlı saniye.
. Saniyeleri saniye parçalarından ayıran bir kültüre duyarlı simge. Sabit biçim bir nokta (".") karakteri kullanır.
ff Bir ila yedi ondalık basamaktan oluşan isteğe bağlı saniye parçası.

bileşenlerinin input , değerine eşit veya ondan büyük ve değerinden küçük veya buna eşit TimeSpan.MinValue bir zaman aralığını toplu olarak belirtmesi gerekir TimeSpan.MaxValue.

yöntemi, TryParse(String, IFormatProvider, TimeSpan) tarafından formatProviderbelirtilen kültür için kültüre özgü biçimlerin her birini kullanarak ayrıştırmaya input çalışır.

formatProvider parametresi, döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir IFormatProvider uygulamadır. formatProvider parametresi aşağıdakilerden biri olabilir:

ise formatProvidernull, DateTimeFormatInfo geçerli kültürle ilişkili nesne kullanılır.

Arayanlara notlar

Bazı durumlarda, ayrıştırılacak dizedeki bir zaman aralığı bileşeni yediden fazla basamak içerdiğinde, .NET Framework 3.5 ve önceki sürümlerde başarılı olan ve döndürülen true ayrıştırma işlemleri başarısız olabilir ve .NET Framework 4 ve sonraki sürümlerde döndürülebilir false . Aşağıdaki örnekte bu senaryo gösterilmektedir:

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'