TimeSpan.Parse Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür.

Aşırı Yüklemeler

Parse(String, IFormatProvider)	Belirtilen kültüre özgü biçim bilgilerini kullanarak bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Belirtilen kültüre özgü biçim bilgilerini kullanarak zaman aralığının span gösterimini TimeSpan eşdeğerine dönüştürür.
Parse(String)	Bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür.

Parse(String, IFormatProvider)

Kaynak:

TimeSpan.cs

Belirtilen kültüre özgü biçim bilgilerini kullanarak bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür.

C#

public static TimeSpan Parse (string input, IFormatProvider? formatProvider);

Parametreler

input

String

Dönüştürülecek zaman aralığını belirten dize.

formatProvider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

Döndürülenler

TimeSpan

formatProvidertarafından belirtilen inputkarşılık gelen zaman aralığı.

Uygulamalar

Parse(String, IFormatProvider)

Özel durumlar

ArgumentNullException

input null.

FormatException

input geçersiz bir biçime sahip.

OverflowException

input TimeSpan.MinValue veya TimeSpan.MaxValuedeğerinden büyük bir sayıyı temsil eder.

-veya-

input gün, saat, dakika veya saniye bileşenlerinden en az biri geçerli aralığının dışındadır.

Örnekler

Aşağıdaki örnek bir CultureInfo nesneleri dizisini tanımlar ve her nesneyi dize dizisindeki öğeleri ayrıştırmak için Parse(String, IFormatProvider) yöntemine yapılan çağrılarda kullanır. Örnekte, belirli bir kültürün kurallarının biçimlendirme işlemini nasıl etkilediği gösterilmektedir.

C#

using System;
using System.Globalization;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string[] values = { "6", "6:12", "6:12:14", "6:12:14:45", 
                          "6.12:14:45", "6:12:14:45.3448", 
                          "6:12:14:45,3448", "6:34:14:45" };
      CultureInfo[] cultures = { new CultureInfo("en-US"), 
                                 new CultureInfo("ru-RU"),
                                 CultureInfo.InvariantCulture };
      
      string header = String.Format("{0,-17}", "String");
      foreach (CultureInfo culture in cultures)
         header += culture.Equals(CultureInfo.InvariantCulture) ? 
                      String.Format("{0,20}", "Invariant") :
                      String.Format("{0,20}", culture.Name);
      Console.WriteLine(header);
      Console.WriteLine();
      
      foreach (string value in values)
      {
         Console.Write("{0,-17}", value);
         foreach (CultureInfo culture in cultures)
         {
            try {
               TimeSpan ts = TimeSpan.Parse(value, culture);
               Console.Write("{0,20}", ts.ToString("c"));
            }
            catch (FormatException) {
               Console.Write("{0,20}", "Bad Format");
            }   
            catch (OverflowException) {
               Console.Write("{0,20}", "Overflow");
            }      
         }
         Console.WriteLine();                                
      }
   }
}
// The example displays the following output:
//    String                          en-US               ru-RU           Invariant
//    
//    6                          6.00:00:00          6.00:00:00          6.00:00:00
//    6:12                         06:12:00            06:12:00            06:12:00
//    6:12:14                      06:12:14            06:12:14            06:12:14
//    6:12:14:45                 6.12:14:45          6.12:14:45          6.12:14:45
//    6.12:14:45                 6.12:14:45          6.12:14:45          6.12:14:45
//    6:12:14:45.3448    6.12:14:45.3448000          Bad Format  6.12:14:45.3448000
//    6:12:14:45,3448            Bad Format  6.12:14:45.3448000          Bad Format
//    6:34:14:45                   Overflow            Overflow            Overflow

Açıklamalar

Bu yöntem, formatProvidertarafından belirtilen kültür için kültüre özgü biçimlerin her birini kullanarak input ayrıştırmaya çalışır.

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

• Biçimlendirme kuralları döndürülen dizeye yansıtılacak olan kültürü temsil eden bir CultureInfo nesnesi. CultureInfo.DateTimeFormat özelliği tarafından döndürülen DateTimeFormatInfo nesnesi, döndürülen dizenin biçimlendirmesini tanımlar.
• Döndürülen dizenin biçimlendirmesini tanımlayan bir DateTimeFormatInfo nesnesi.
• IFormatProvider arabirimini uygulayan özel bir nesne. IFormatProvider.GetFormat yöntemi, biçimlendirme bilgileri sağlayan bir DateTimeFormatInfo nesnesi döndürür.

formatProvider nullise, geçerli kültürle ilişkili DateTimeFormatInfo nesnesi kullanılır.

Bu API hakkında daha fazla bilgi için bkz. System.TimeSpan.Parseiçin ek API açıklamaları.

Parse(ReadOnlySpan<Char>, IFormatProvider)

Kaynak:

TimeSpan.cs

Belirtilen kültüre özgü biçim bilgilerini kullanarak zaman aralığının span gösterimini TimeSpan eşdeğerine dönüştürür.

C#

public static TimeSpan Parse (ReadOnlySpan<char> input, IFormatProvider? formatProvider = default);

Parametreler

input

ReadOnlySpan<Char>

Dönüştürülecek zaman aralığını temsil eden karakterleri içeren bir yayılma alanı.

formatProvider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

Döndürülenler

TimeSpan

formatProvidertarafından belirtilen inputkarşılık gelen zaman aralığı.

Uygulamalar

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(String)

Kaynak:

TimeSpan.cs

Bir zaman aralığının dize gösterimini TimeSpan eşdeğerine dönüştürür.

C#

public static TimeSpan Parse (string s);

Parametreler

s

String

Dönüştürülecek zaman aralığını belirten dize.

Döndürülenler

TimeSpan

skarşılık gelen bir zaman aralığı.

Özel durumlar

ArgumentNullException

s null.

FormatException

s geçersiz bir biçime sahip.

OverflowException

s TimeSpan.MinValue veya TimeSpan.MaxValuedeğerinden büyük bir sayıyı temsil eder.

-veya-

Gün, saat, dakika veya saniye bileşenlerinden en az biri geçerli aralığının dışındadır.

Örnekler

Aşağıdaki örnekte, bir dize dizisindeki her öğeyi bir TimeSpan değerine dönüştürmek için Parse yöntemi kullanılmaktadır. Mevcut sistem kültürünün ayrıştırma işlemini nasıl etkilediğini göstermek için mevcut sistem kültürünü Hırvat - Hırvatistan ("hr-HR") ve İngilizce - ABD ("en-US") olarak değiştiriyor.

C#

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      string[] values = { "6", "6:12", "6:12:14", "6:12:14:45", 
                          "6.12:14:45", "6:12:14:45.3448", 
                          "6:12:14:45,3448", "6:34:14:45" };
      string[] cultureNames = { "hr-HR", "en-US"};
      
      // Change the current culture.
      foreach (string cultureName in cultureNames)
      {
         Thread.CurrentThread.CurrentCulture = new CultureInfo(cultureName);
         Console.WriteLine("Current Culture: {0}", 
                           Thread.CurrentThread.CurrentCulture.Name);
         foreach (string value in values)
         {
            try {
               TimeSpan ts = TimeSpan.Parse(value);
               Console.WriteLine("{0} --> {1}", value, ts.ToString("c"));
            }
            catch (FormatException) {
               Console.WriteLine("{0}: Bad Format", value);
            }   
            catch (OverflowException) {
               Console.WriteLine("{0}: Overflow", value);
            }
         } 
         Console.WriteLine();                                
      }
   }
}
// The example displays the following output:
//    Current Culture: hr-HR
//    6 --> 6.00:00:00
//    6:12 --> 06:12:00
//    6:12:14 --> 06:12:14
//    6:12:14:45 --> 6.12:14:45
//    6.12:14:45 --> 6.12:14:45
//    6:12:14:45.3448: Bad Format
//    6:12:14:45,3448 --> 6.12:14:45.3448000
//    6:34:14:45: Overflow
//    
//    Current Culture: en-US
//    6 --> 6.00:00:00
//    6:12 --> 06:12:00
//    6:12:14 --> 06:12:14
//    6:12:14:45 --> 6.12:14:45
//    6.12:14:45 --> 6.12:14:45
//    6:12:14:45.3448 --> 6.12:14:45.3448000
//    6:12:14:45,3448: Bad Format
//    6:34:14:45: Overflow

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz. TimeSpan.Parseiçin ek API açıklamaları .