TimeSpan.Parse Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Konvertiert die Zeichenfolgendarstellung eines Zeitintervalls in dessen TimeSpan Entsprechung.

Überlädt

Parse(String, IFormatProvider)	Konvertiert die Zeichenfolgendarstellung eines Zeitintervalls in die TimeSpan Entsprechung mithilfe der angegebenen kulturspezifischen Formatinformationen.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Wandelt die Spandarstellung eines Zeitintervalls mithilfe der angegebenen kulturspezifischen Formatinformationen in das TimeSpan Äquivalent um.
Parse(String)	Konvertiert die Zeichenfolgendarstellung eines Zeitintervalls in dessen TimeSpan Entsprechung.

Parse(String, IFormatProvider)

Quelle:: TimeSpan.cs

Quelle:: TimeSpan.cs

Quelle:: TimeSpan.cs

Konvertiert die Zeichenfolgendarstellung eines Zeitintervalls in die TimeSpan Entsprechung mithilfe der angegebenen kulturspezifischen Formatinformationen.

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

Parameter

input: String

Eine Zeichenfolge, die das zu konvertierende Zeitintervall angibt.

formatProvider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

TimeSpan

Ein Zeitintervall, das inputentspricht, wie durch formatProviderangegeben.

Implementiert

Parse(String, IFormatProvider)

Ausnahmen

ArgumentNullException

input ist null.

FormatException

input weist ein ungültiges Format auf.

OverflowException

input stellt eine Zahl dar, die kleiner als TimeSpan.MinValue oder größer als TimeSpan.MaxValueist.

-oder-

Mindestens eine der Komponenten für Tage, Stunden, Minuten oder Sekunden in input liegt außerhalb des gültigen Bereichs.

Beispiele

Im folgenden Beispiel wird ein Array von CultureInfo Objekten definiert und jedes Objekt in Aufrufen der Parse(String, IFormatProvider)-Methode verwendet, um die Elemente in einem Zeichenfolgenarray zu analysieren. Das Beispiel veranschaulicht, wie sich die Konventionen einer bestimmten Kultur auf den Formatierungsvorgang auswirken.

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

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

Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      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
   End Sub
End Module
' 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

Hinweise

Diese Methode versucht, input zu analysieren, indem jedes der kulturspezifischen Formate für die durch formatProviderangegebene Kultur verwendet wird.

Der formatProvider-Parameter ist eine IFormatProvider Implementierung, die kulturspezifische Informationen zum Format der zurückgegebenen Zeichenfolge bereitstellt. Der formatProvider-Parameter kann eine der folgenden Sein:

Ein CultureInfo-Objekt, das die Kultur darstellt, deren Formatierungskonventionen in der zurückgegebenen Zeichenfolge widergespiegelt werden sollen. Das von der CultureInfo.DateTimeFormat -Eigenschaft zurückgegebene DateTimeFormatInfo -Objekt definiert die Formatierung der zurückgegebenen Zeichenfolge.
Ein DateTimeFormatInfo-Objekt, das die Formatierung der zurückgegebenen Zeichenfolge definiert.
Ein benutzerdefiniertes Objekt, das die IFormatProvider Schnittstelle implementiert. Die IFormatProvider.GetFormat-Methode gibt ein DateTimeFormatInfo Objekt zurück, das Formatierungsinformationen bereitstellt.

Wenn formatProvidernullist, wird das DateTimeFormatInfo-Objekt verwendet, das der aktuellen Kultur zugeordnet ist.

Weitere Informationen zu dieser API finden Sie in Ergänzende API-Hinweise für System.TimeSpan.Parse.

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider)

Quelle:: TimeSpan.cs

Quelle:: TimeSpan.cs

Quelle:: TimeSpan.cs

Wandelt die Spandarstellung eines Zeitintervalls mithilfe der angegebenen kulturspezifischen Formatinformationen in das TimeSpan Äquivalent um.

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

Parameter

input: ReadOnlySpan<Char>

Eine Spanne mit den Zeichen, die das zu konvertierende Zeitintervall darstellen.

formatProvider: IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

TimeSpan

Ein Zeitintervall, das inputentspricht, wie durch formatProviderangegeben.

Implementiert

Parse(ReadOnlySpan<Char>, IFormatProvider)

Gilt für:

Parse(String)

Quelle:: TimeSpan.cs

Quelle:: TimeSpan.cs

Quelle:: TimeSpan.cs

Konvertiert die Zeichenfolgendarstellung eines Zeitintervalls in dessen TimeSpan Entsprechung.

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

Parameter

s: String

Eine Zeichenfolge, die das zu konvertierende Zeitintervall angibt.

Gibt zurück

TimeSpan

Ein Zeitintervall, das sentspricht.

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s weist ein ungültiges Format auf.

OverflowException

s stellt eine Zahl dar, die kleiner als TimeSpan.MinValue oder größer als TimeSpan.MaxValueist.

-oder-

Mindestens eine der Komponenten für Tage, Stunden, Minuten oder Sekunden liegt außerhalb des gültigen Bereichs.

Beispiele

Im folgenden Beispiel wird die Parse-Methode verwendet, um jedes Element in einem Zeichenfolgenarray in einen TimeSpan Wert zu konvertieren. Es ändert die aktuelle Systemkultur in Kroatisch - Kroatien ("hr-HR") und Englisch - Vereinigte Staaten ("en-US") um zu veranschaulichen, wie sich die aktuelle Systemkultur auf den Analysevorgang auswirkt.

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

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

Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      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
   End Sub
End Module
' 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

Hinweise

Weitere Informationen zu dieser API finden Sie unter Ergänzende API-Hinweise für TimeSpan.Parse.

Gilt für:

Freigeben über

TimeSpan.Parse Methode

Definition

Überlädt

Parse(String, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Gilt für:

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parameter

Gibt zurück

Implementiert

Gilt für:

Parse(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Zusätzliche Ressourcen