TimeSpan-Struktur

Sie können auf vielfältige Weise einen TimeSpan-Wert instanziieren:

• Durch Aufrufen von dessen implizitem Standardkonstruktor. Dies erstellt ein Objekt, dessen Wert TimeSpan.Zero ist, wie das folgende Beispiel zeigt.

  C#

  VB

  Kopieren

  
  TimeSpan interval = new TimeSpan();
  Console.WriteLine(interval.Equals(TimeSpan.Zero));    // Displays "True".
  
  
  

• Durch Aufrufen eines zugehörigen expliziten Konstruktors. Im folgenden Beispiel wird ein TimeSpan-Wert mit der angegebenen Anzahl von Stunden, Minuten und Sekunden initialisiert.

  C#

  VB

  Kopieren

  
  TimeSpan interval = new TimeSpan(2, 14, 18);
  Console.WriteLine(interval.ToString());              // Displays "02:14:18".
  
  
  

• Durch Aufrufen einer Methode oder Ausführen einer Operation, die einen TimeSpan-Wert zurückgibt. Sie können z. B. einen TimeSpan-Wert instanziieren, der das Intervall zwischen zwei Datums- und Uhrzeitwerten darstellt, wie das folgende Beispiel zeigt.

  C#

  VB

  Kopieren

  
  DateTime departure = new DateTime(2010, 6, 12, 18, 32, 0);
  DateTime arrival = new DateTime(2010, 6, 13, 22, 47, 0);
  TimeSpan travelTime = arrival - departure;  
  Console.WriteLine("{0} - {1} = {2}", arrival, departure, travelTime);      
  // The example displays the following output:
  //       6/13/2010 10:47:00 PM - 6/12/2010 6:32:00 PM = 1.04:15:00
  
  
  

  TimeSpan-Werte werden von arithmetischen Operatoren und Methoden der Strukturen DateTime, DateTimeOffset und TimeSpan zurückgegeben.

• Durch das Analysieren der Zeichenfolgendarstellung eines TimeSpan-Werts. Sie können Zeichenfolgen, die Zeitintervalle zu TimeSpan-Werten enthalten, mithilfe der Parse-Methode und TryParse-Methode konvertieren. Im folgenden Beispiel wird die Parse-Methode verwendet, um ein Array von Zeichenfolgen in TimeSpan-Werte zu konvertieren.

  C#

  VB

  Kopieren

  
  string[] values = { "12", "31.", "5.8:32:16", "12:12:15.95", ".12"};
  foreach (string value in values)
  {
     try {
        TimeSpan ts = TimeSpan.Parse(value);
        Console.WriteLine("'{0}' --> {1}", value, ts);
     }
     catch (FormatException) {
        Console.WriteLine("Unable to parse '{0}'", value);
     }
     catch (OverflowException) {
        Console.WriteLine("'{0}' is outside the range of a TimeSpan.", value);
     }   
  }
  // The example displays the following output:
  //       '12' --> 12.00:00:00
  //       Unable to parse '31.'
  //       '5.8:32:16' --> 5.08:32:16
  //       '12:12:15.95' --> 12:12:15.9500000
  //       Unable to parse '.12'  
  
  
  

  Außerdem können Sie das präzise Format der zu analysierenden Eingabezeichenfolge definieren und durch Aufrufen der ParseExact-Methode oder TryParseExact-Methode in einen TimeSpan-Wert konvertieren.

Sie können Zeitdauern addieren und subtrahieren, indem Sie den Addition-Operator und Subtraction-Operator verwenden oder durch das Aufrufen der Add-Methode und Subtract-Methode. Sie können auch zwei Zeitdauern vergleichen, indem Sie die Methoden Compare, CompareTo und Equals aufrufen. Die TimeSpan-Klasse schließt auch die Duration-Methode und Negate-Methode ein, die Zeitintervalle in positive und negative Werte konvertieren,

Der Bereich von TimeSpan-Werten ist MinValue bis MaxValue.

Ein TimeSpan-Wert kann als [-]d.hh:mm:ss.ff dargestellt werden. Dabei gibt das optionale Minuszeichen ein negatives Zeitintervall an, die d-Komponente stellt die Tage dar, hh bezeichnet die Stunden im 24-Stunden-Format, mm sind die Minuten, ss die Sekunden und ff die Sekundenbruchteile. Ein Zeitintervall besteht also aus einer positiven oder negativen Anzahl von Tagen ohne eine Tageszeit oder einer Anzahl von Tagen mit einer Tageszeit oder aus nur einer Tageszeit.

Ab .NET Framework, Version 4 unterstützt die TimeSpan-Struktur kulturabhängige Formatierungen durch die Überladungen ihrer ToString-Methode, die einen TimeSpan-Wert in seine Zeichenfolgendarstellung konvertiert. Die TimeSpan.ToString()-Standardmethode gibt ein Zeitintervall mit einem unveränderlichen Format zurück, das mit dem entsprechenden Rückgabewert in früheren Versionen von .NET Framework übereinstimmt. Die TimeSpan.ToString(String)-Überladung ermöglicht, eine Formatzeichenfolge anzugeben, die die Zeichenfolgendarstellung des Zeitintervalls definiert. Die TimeSpan.ToString(String, IFormatProvider)-Überladung ermöglicht das Angeben einer Formatzeichenfolge und der Kultur, deren Formatierungskonventionen verwendet werden, um die Zeichenfolgendarstellung des Zeitintervalls zu erstellen. TimeSpan unterstützt sowohl Standard- als auch benutzerdefinierte Formatzeichenfolgen. (Weitere Informationen finden Sie unter TimeSpan-Standardformatzeichenfolgen und Benutzerdefinierte TimeSpan-Formatzeichenfolgen). Nur Standardformatzeichenfolgen sind jedoch kulturabhängig.

In einigen Fällen schlägt Code, der TimeSpan-Werte in .NET Framework 3.5 und früheren Versionen erfolgreich formatiert, in .NET Framework 4 fehl. Dies ist sehr häufig in Code, in dem eine Methode für kombinierte Formatierungen aufgerufen wird, um einen TimeSpan-Wert mit einer Formatzeichenfolge zu formatieren. Im folgenden Beispiel wird erfolgreich ein TimeSpan-Wert in .NET Framework 3.5 und früheren Versionen formatiert, aber in .NET Framework 4 und höheren Versionen wird eine Ausnahme ausgelöst. Beachten Sie, dass es versucht, einen TimeSpan-Wert mit einem nicht unterstützten Formatbezeichner zu formatieren, der in .NET Framework 3.5 und früheren Versionen ignoriert wird.

TimeSpan interval = new TimeSpan(12, 30, 45);
string output;
try {
   output = String.Format("{0:r}", interval);
}
catch (FormatException) {
   output = "Invalid Format";
}
Console.WriteLine(output);
// Output from .NET Framework 3.5 and earlier versions:
//       12:30:45
// Output from .NET Framework 4:
//       Invalid Format

Wenn Sie den Code nicht ändern können, können Sie die Legacyformatierung von TimeSpan-Werten auf folgende Arten wiederherstellen:

• Durch Erstellen einer Konfigurationsdatei, die das <TimeSpan_LegacyFormatMode>-Element enthält. Durch Festlegen des enabled-Attributs dieses Elements auf true wird die Vorgänger-TimeSpan-Formatierung anwendungsbasiert wiederhergestellt.

• Durch Festlegen des "NetFx40_TimeSpanLegacyFormatMode" Kompatibilitätsschalters beim Erstellen einer Anwendungsdomäne. Dies ermöglicht eine Legacy-TimeSpan-Formatierung auf Anwendungsdomänenbasis. Im folgenden Beispiel wird eine Anwendungsdomäne erstellt, die TimeSpan-Legacyformatierung verwendet.

  C#

  VB

  Kopieren

  
  using System;
  
  public class Example
  {
     public static void Main()
     {
        AppDomainSetup appSetup = new AppDomainSetup();
        appSetup.SetCompatibilitySwitches( new string[] { "NetFx40_TimeSpanLegacyFormatMode" } );
        AppDomain legacyDomain = AppDomain.CreateDomain("legacyDomain", 
                                                        null, appSetup);
        legacyDomain.ExecuteAssembly("ShowTimeSpan.exe");
     }
  }
  
  
  

  Wenn der folgende Code in der neuen Anwendungsdomäne ausgeführt wird, wird er auf älteres TimeSpan-Formatierungsverhalten zurückgesetzt.

  C#

  VB

  Kopieren

  
  using System;
  
  public class Example
  {
     public static void Main()
     {
        TimeSpan interval = DateTime.Now - DateTime.Now.Date;
        string msg = String.Format("Elapsed Time Today: {0:d} hours.",
                                   interval);
        Console.WriteLine(msg);
     }
  }
  // The example displays the following output:
  //       Elapsed Time Today: 01:40:52.2524662 hours.