TimeSpan.Parse Yöntem

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Runtime.dll

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: netstandard.dll

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Aşırı Yüklemeler

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

Parse(ReadOnlySpan<Char>, IFormatProvider)

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

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

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

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

static member Parse : ReadOnlySpan<char> * IFormatProvider -> TimeSpan

Public Shared Function Parse (input As ReadOnlySpan(Of Char), Optional formatProvider As IFormatProvider = Nothing) As TimeSpan

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

tarafından inputbelirtildiği gibi öğesine formatProviderkarşılık gelen bir zaman aralığı.

Uygulamalar

Parse(ReadOnlySpan<Char>, IFormatProvider)

Şunlara uygulanır

Parse(String, IFormatProvider)

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

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

public:
 static TimeSpan Parse(System::String ^ input, IFormatProvider ^ formatProvider);

public:
 static TimeSpan Parse(System::String ^ input, IFormatProvider ^ formatProvider) = IParsable<TimeSpan>::Parse;

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

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

static member Parse : string * IFormatProvider -> TimeSpan

Public Shared Function Parse (input As String, formatProvider As IFormatProvider) As TimeSpan

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

tarafından inputbelirtildiği gibi öğesine formatProviderkarşılık gelen bir zaman aralığı.

Uygulamalar

Parse(String, IFormatProvider)

Özel durumlar

ArgumentNullException

input, null'e eşittir.

FormatException

input geçersiz bir biçime sahip.

OverflowException

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

-veya-

içindeki 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 nesne dizisini CultureInfo tanımlar ve bir dize dizisindeki öğeleri ayrıştırmak için yöntemine yapılan çağrılardaki Parse(String, IFormatProvider) her nesneyi kullanır. Örnekte, belirli bir kültürün kurallarının biçimlendirme işlemini nasıl etkilediği gösterilmektedir.

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

public class Example2
{
   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

open System
open System.Globalization
open System.Text.RegularExpressions

let 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" |]
let cultures = 
    [| CultureInfo "en-US" 
       CultureInfo "ru-RU"
       CultureInfo.InvariantCulture |]

let mutable header = $"""{"String",-17}"""
for culture in cultures do
    header <- header +
        if culture.Equals CultureInfo.InvariantCulture then 
            $"""{"Invariant",20}"""
        else
            $"{culture.Name,20}"
printfn $"{header}\m"

for value in values do
    printf $"{value,-17}"
    for culture in cultures do
        try
            let ts = TimeSpan.Parse(value, culture)
            printf $"{ts,20:c}"
        with
        | :? FormatException ->
            printf $"""{"Bad Format",20}"""
        | :? OverflowException ->
            printf $"""{"Overflow",20}"""
    printfn ""                      
// 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

Dim values() As String = {"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"}
Dim cultures() As CultureInfo = {New CultureInfo("en-US"),
                                New CultureInfo("ru-RU"),
                                CultureInfo.InvariantCulture}

Dim header As String = String.Format("{0,-17}", "String")
For Each culture As CultureInfo In cultures
    header += If(culture.Equals(CultureInfo.InvariantCulture),
              String.Format("{0,20}", "Invariant"),
              String.Format("{0,20}", culture.Name))
Next
Console.WriteLine(header)
Console.WriteLine()

For Each value As String In values
    Console.Write("{0,-17}", value)
    For Each culture As CultureInfo In cultures
        Try
            Dim ts As TimeSpan = TimeSpan.Parse(value, culture)
            Console.Write("{0,20}", ts.ToString("c"))
        Catch e As FormatException
            Console.Write("{0,20}", "Bad Format")
        Catch e As OverflowException
            Console.Write("{0,20}", "Overflow")
        End Try
    Next
    Console.WriteLine()
Next

' 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, tarafından inputbelirtilen kültür için kültüre özgü biçimlerin her birini kullanarak ayrıştırmaya formatProvider ç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:

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

Eğer formatProvidernull ise, geçerli kültürle ilişkili olan DateTimeFormatInfo nesnesi kullanılır.

Yöntemlerin Parse giriş dizesi, formda bir zaman aralığı belirtimi içerir:

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

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

Öğe	Description
Ws	İsteğe bağlı boşluk.
-	İsteğe bağlı bir eksi işareti, negatif bir TimeSpan olduğunu gösterir.
d	0 ile 10675199 arasında değişen günler.
.	Günleri saatlerden ayıran kültüre duyarlı bir simge. Sabit biçim nokta (".") karakterini kullanır.
Hh	0 ile 23 arasında değişen saatler.
:	Kültüre duyarlı zaman ayırıcı simgesi. Sabit biçim iki nokta üst üste (":") karakteri kullanır.
Mm	0 ile 59 arasında değişen dakikalar.
ss	0 ile 59 arasında değişen isteğe bağlı saniyeler.
.	Saniyeleri saniyenin kesirlerinden ayıran kültüre duyarlı simge. Sabit biçim nokta (".") karakterini kullanır.
Ff	İsteğe bağlı kesirli saniyeler, bir ile yedi arası ondalık basamaktan oluşur.

Giriş dizesi yalnızca bir gün değeri değilse, saat ve dakika bileşeni içermelidir; diğer bileşenler isteğe bağlıdır. Bunlar varsa, her zaman bileşeninin değerleri belirtilen aralık içinde olmalıdır. Örneğin, saat bileşeni olan ss değerinin 0 ile 23 arasında olması gerekir. Bu nedenle, "23:00:00" değerinin Parse yöntemine geçirilmesi 23 saatlik bir zaman aralığı döndürür. Öte yandan, "24:00:00" parametresinin gönderilmesi 24 günlük bir zaman aralığı olarak geri döner. "24" saat bileşeni aralığının dışında olduğundan, gün bileşeni olarak yorumlanır.

Giriş dizesinin bileşenleri toplu olarak değerinden büyük veya buna eşit TimeSpan.MinValue ve değerinden küçük veya eşit TimeSpan.MaxValuebir zaman aralığı belirtmelidir.

Parse(String) yöntemi, geçerli kültüre özgü her biçimi kullanarak giriş dizesini ayrıştırmaya çalışır.

Şunlara uygulanır

Parse(String)

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

Kaynak:: TimeSpan.cs

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

public:
 static TimeSpan Parse(System::String ^ s);

public static TimeSpan Parse(string s);

static member Parse : string -> TimeSpan

Public Shared Function Parse (s As String) As TimeSpan

Parametreler

s: String

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

Döndürülenler

TimeSpan

öğesine karşılık gelen sbir zaman aralığı.

Özel durumlar

ArgumentNullException

s, null'e eşittir.

FormatException

s geçersiz bir biçime sahip.

OverflowException

s TimeSpan.MinValue değerinden küçük veya TimeSpan.MaxValue değ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 örnek, bir dize dizisindeki her öğeyi bir Parse değere dönüştürmek için yöntemini kullanırTimeSpan. 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.

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

public class Example1
{
   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

open System
open System.Globalization
open System.Threading

let 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" |]
let cultureNames = [| "hr-HR"; "en-US" |]

// Change the current culture.
for cultureName in cultureNames do
    Thread.CurrentThread.CurrentCulture <- CultureInfo cultureName
    printfn $"Current Culture: {Thread.CurrentThread.CurrentCulture.Name}" 
    for value in values do
        try 
            let ts = TimeSpan.Parse value
            printfn $"{value} --> {ts:c}"
        with 
        | :? FormatException ->
            printfn $"{value}: Bad Format"
        | :? OverflowException ->
            printfn $"{value}: Overflow"
    printfn ""                                
// 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

Dim values() As String = {"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"}
Dim cultureNames() As String = {"hr-HR", "en-US"}

' Change the current culture.
For Each cultureName As String In cultureNames
    Thread.CurrentThread.CurrentCulture = New CultureInfo(cultureName)
    Console.WriteLine("Current Culture: {0}",
                   Thread.CurrentThread.CurrentCulture.Name)
    For Each value As String In values
        Try
            Dim ts As TimeSpan = TimeSpan.Parse(value)
            Console.WriteLine("{0} --> {1}", value, ts.ToString("c"))
        Catch e As FormatException
            Console.WriteLine("{0}: Bad Format", value)
        Catch e As OverflowException
            Console.WriteLine("{0}: Overflow", value)
        End Try
    Next
    Console.WriteLine()
Next

' 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

Yöntemlerin Parse giriş dizesi, formda bir zaman aralığı belirtimi içerir:

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

Öğe	Description
Ws	İsteğe bağlı boşluk.
-	İsteğe bağlı bir eksi işareti, negatif bir TimeSpan olduğunu gösterir.
d	0 ile 10675199 arasında değişen günler.
.	Günleri saatlerden ayıran kültüre duyarlı bir simge. Sabit biçim nokta (".") karakterini kullanır.
Hh	0 ile 23 arasında değişen saatler.
:	Kültüre duyarlı zaman ayırıcı simgesi. Sabit biçim iki nokta üst üste (":") karakteri kullanır.
Mm	0 ile 59 arasında değişen dakikalar.
ss	0 ile 59 arasında değişen isteğe bağlı saniyeler.
.	Saniyeleri saniyenin kesirlerinden ayıran kültüre duyarlı simge. Sabit biçim nokta (".") karakterini kullanır.
Ff	İsteğe bağlı kesirli saniyeler, bir ile yedi arası ondalık basamaktan oluşur.

Giriş dizesinin bileşenleri toplu olarak değerinden büyük veya buna eşit TimeSpan.MinValue ve değerinden küçük veya eşit TimeSpan.MaxValuebir zaman aralığı belirtmelidir.

Parse(String) yöntemi, geçerli kültüre özgü her biçimi kullanarak giriş dizesini ayrıştırmaya çalışır.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?