Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

TimeSpan.Parse-Methode: (String)

 

Veröffentlicht: Oktober 2016

Konvertiert die Zeichenfolgendarstellung eines Zeitintervalls in die entsprechende TimeSpan.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

public static TimeSpan Parse(
	string s
)

Parameter

s
Type: System.String

Eine Zeichenfolge, die das zu konvertierende Zeitintervall angibt.

Rückgabewert

Type: System.TimeSpan

Ein Zeitintervall, das s entspricht.

Exception Condition
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.MaxValue ist.

- oder -

Mindestens eine der Tages-, Stunden-, Minuten- oder Sekundenkomponenten liegt außerhalb des gültigen Bereichs.

Die s Parameter enthält eine Spezifikation Zeitintervall, in der Form:

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

Elemente in eckigen Klammern ([ und ]) sind optional. Eine Auswahl aus der Liste der alternativen in geschweiften Klammern ({und}) und getrennt durch senkrechte Striche (|) ist erforderlich. In der folgenden Tabelle wird jedes Element beschrieben.

Element

Beschreibung

ws

Optionaler Leerraum.

-

Einen optionalen Minuszeichen (-), womit eine Negative TimeSpan.

d

Tage, im Bereich von 0 bis 10675199.

.

Eine kulturabhängige-Symbol, das Tage von Stunden trennt. Unveränderlichen Format verwendet einen Punkt (".") ersetzt wurde.

hh

Stunden, zwischen 0 und 23.

:

Das Trennzeichen für kulturabhängige Zeit. Das unveränderliche Format verwendet, einen Doppelpunkt (":") Zeichen.

mm

Minuten im Bereich von 0 bis 59.

ss

Sekunden, optional im Bereich von 0 bis 59.

.

Eine kulturabhängige-Symbol, das Sekunden von Sekundenbruchteilen trennt. Unveränderlichen Format verwendet einen Punkt (".") ersetzt wurde.

ff

Optionale Bruchteilen von Sekunden, bestehend aus 1 bis 7 Dezimalstellen.

Die Komponenten der s geben müssen zusammen ein Zeitintervall, das größer als oder gleich TimeSpan.MinValue und kleiner oder gleich TimeSpan.MaxValue.

Die Parse(String) Methode versucht, Analysieren s mithilfe der einzelnen der kulturspezifische Formate für die aktuelle Kultur.

Hinweise für Aufrufer:

Wenn eine Zeitkomponente Intervall, in der Zeichenfolge, die analysiert werden mehr als sieben Ziffern enthält, in Analysevorgängen der .NET Framework 3.5 und frühere Versionen möglicherweise Verhalten sich anders als in Analysevorgängen der .NET Framework 4. In einigen Fällen Analysevorgängen, die in erfolgreich die .NET Framework 3.5 und früheren Versionen möglicherweise fehl, und löst eine OverflowException in der .NET Framework 4. In anderen Fällen Analysevorgängen, die Auslösen einer FormatException in der .NET Framework 3.5 und früheren Versionen möglicherweise fehl, und löst ein OverflowException in der .NET Framework 4. Das folgende Beispiel veranschaulicht beide Szenarien.

string[] values = { "000000006", "12.12:12:12.12345678" };
foreach (string value in values)
{
   try {
      TimeSpan interval = TimeSpan.Parse(value);
      Console.WriteLine("{0} --> {1}", value, interval);
   }   
   catch (FormatException) {
      Console.WriteLine("{0}: Bad Format", value);
   }   
   catch (OverflowException) {
      Console.WriteLine("{0}: Overflow", value);
   }
}
// Output from .NET Framework 3.5 and earlier versions:
//       000000006 --> 6.00:00:00
//       12.12:12:12.12345678: Bad Format      
// Output from .NET Framework 4:
//       000000006: Overflow
//       12.12:12:12.12345678: Overflow

Im folgenden Beispiel wird die Parse Methode, um jedes Element in ein Zeichenfolgenarray, das Konvertieren einer TimeSpan Wert. Es ändert die aktuelle Systemkultur, Kroatisch - Kroatien ("hr-HR") und Englisch - USA ("En-US") zu veranschaulichen, wie die aktuelle Systemkultur der 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

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: