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, IFormatProvider)

.NET Framework (current version)
 

Konvertiert die Zeichenfolgendarstellung eines Zeitintervalls unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende TimeSpan.

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

public static TimeSpan Parse(
	string input,
	IFormatProvider formatProvider
)

Parameter

input
Type: System.String

Eine Zeichenfolge, die das zu konvertierende Zeitintervall angibt.

formatProvider
Type: System.IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Rückgabewert

Type: System.TimeSpan

Ein Zeitintervall, das input entspricht, wie von formatProvider angegeben.

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

- oder -

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

Die input Parameter enthält ein Intervall Zeitangabe 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 durch senkrechte Striche (|) ist erforderlich. In der folgenden Tabelle wird jedes Element beschrieben.

Element

Beschreibung

ws

Optionaler Leerraum.

-

Ein optionales Minuszeichen, womit eine Negative TimeSpan.

d

Tage, Werte zwischen 0 und 10675199.

.

Eine kulturabhängige-Symbol, das Tage von Stunden trennt. Der Standardwert ist ein Punkt (".") ersetzt wurde.

hh

Stunden, Werte zwischen 0 und 23.

:

Der kulturabhängige Zeit-Trennzeichen.

mm

Minuten, Werte zwischen 0 und 59.

ss

Optionale Sekunden, Werte zwischen 0 und 59.

.

Eine kulturabhängige-Symbol, das Sekunden von Sekundenbruchteilen trennt. Der Standardwert ist ein Punkt (".") ersetzt wurde.

ff

Optionale Bruchteilen von Sekunden, 1 bis 7 Dezimalstellen.

Die Komponenten der input müssen zusammen angeben ein bestimmten Zeitintervalls, die größer als oder gleich TimeSpan.MinValue und kleiner als oder gleich TimeSpan.MaxValue.

Die Parse(String) -Methode versucht, input mit den einzelnen kulturspezifischen Formaten für die Kultur mit dem angegebenen formatProvider.

Der formatProvider -Parameter ist ein IFormatProvider Implementierung, die kulturspezifische Informationen zum Format der zurückgegebenen Zeichenfolge bereitstellt. Die formatProvider Parameter kann einen der folgenden sein:

Wenn formatProvider ist null, die DateTimeFormatInfo -Objekt, das der aktuellen Kultur zugeordnet ist, wird verwendet.

Hinweise zu Aufrufern:

Wenn eine in der Zeichenfolge, die analysiert werden enthält mehr als sieben Ziffern Analysevorgänge in die .NET Framework 3,5 und frühere Versionen möglicherweise andere Verhaltensweise als die Analysevorgänge in der .NET Framework 4. In einigen Fällen Analysieren von Operationen, die erfolgreich in die .NET Framework 3,5 und frühere 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ühere Versionen möglicherweise fehl und löst eine 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 folgende Beispiel wird ein Array von CultureInfo -Objekten, und jedes Objekt in Aufrufe an die Parse(String, IFormatProvider) Methode, um die Elemente in einem Zeichenfolgenarray zu analysieren. Im Beispiel wird veranschaulicht, wie die Konventionen einer bestimmten Kultur den Formatierungsvorgang beeinflussen.

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

Universal Windows Platform
Verfügbar seit 4.5
.NET Framework
Verfügbar seit 4.0
Portable Class Library
Unterstützt in: portable .NET platforms
Silverlight
Verfügbar seit 4.0
Windows Phone Silverlight
Verfügbar seit 7.1
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: