Struttura TimeSpan

È possibile creare un'istanza di un valore TimeSpan in diversi modi:

• Tramite la chiamata al relativo costruttore predefinito. Questo crea un oggetto il cui valore è TimeSpan.Zero, come mostra l'esempio seguente.

  C#

  VB

  Copia

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

• Chiamando uno dei costruttori espliciti. Nell'esempio riportato di seguito viene inizializzato un valore TimeSpan su un numero di ore, minuti e secondi specificato.

  C#

  VB

  Copia

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

• Tramite la chiamata a un metodo o l'esecuzione di un'operazione che restituisce un valore TimeSpan. Ad esempio, è possibile creare un'istanza di un valore TimeSpan che rappresenta l'intervallo tra due valori di data e ora, come mostra l'esempio seguente.

  C#

  VB

  Copia

  
  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
  
  
  

  È inoltre possibile inizializzare un oggetto TimeSpan a un valore zero in questo modo, come illustrato di seguito.

  C#

  VB

  Copia

  
  using System;
  
  public class Example
  {
     static Random rnd = new Random();
  
     public static void Main()
     {
        TimeSpan timeSpent = TimeSpan.Zero;
  
        timeSpent += GetTimeBeforeLunch();
        timeSpent += GetTimeAfterLunch();
  
        Console.WriteLine("Total time: {0}", timeSpent);
     }
  
     private static TimeSpan GetTimeBeforeLunch()
     {
        return new TimeSpan(rnd.Next(3, 6), 0, 0);
     }
  
     private static TimeSpan GetTimeAfterLunch()
     {
        return new TimeSpan(rnd.Next(3, 6), 0, 0);
     }
  }
  // The example displays output like the following:
  //        Total time: 08:00:00
  
  
  

  I valori TimeSpan vengono restituiti da operatori aritmetici e dai metodi delle strutture DateTime, DateTimeOffset e TimeSpan.

• Analizzando la rappresentazione di stringa di valore TimeSpan. È possibile utilizzare i metodi Parse e TryParse per convertire stringhe che contengono intervalli di tempo in valori TimeSpan. Nell'esempio che segue viene utilizzato il metodo Parse per convertire una matrice di stringhe in valori TimeSpan.

  C#

  VB

  Copia

  
  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'  
  
  
  

  Inoltre, è possibile definire il formato preciso della stringa di input da analizzare e convertire in un valore TimeSpan chiamando il metodo ParseExact o TryParseExact.

È possibile aggiungere e sottrarre le durate tramite gli operatori Addition e Subtraction o chiamando i metodi Add e Subtract. È inoltre possibile paragonare due durate chiamando i metodi Compare, CompareTo e Equals. La classe TimeSpan include anche i metodi Duration e Negate che convertono intervalli di tempo in valori positivi e negativi.

L'intervallo dei valori TimeSpan è compreso tra MinValue e MaxValue.

Un valore TimeSpan può essere rappresentato come [-]d.hh:mm:ss.ff, dove il segno di sottrazione facoltativo indica un intervallo di tempo negativo, il componente d indica i giorni, hh le ore nel formato 24 ore, mm i minuti, ss i secondi e ff le frazioni di un secondo. Un intervallo di tempo è quindi costituito da un numero positivo o negativo di giorni senza indicazione dell'ora, da un numero di giorni con l'indicazione dell'ora o solo da un'ora del giorno.

Iniziando con .NET Framework 4, la struttura TimeSpan supporta la formattazione dipendente dalle impostazioni cultura tramite gli overload del metodo ToString che converte un valore TimeSpan nella rappresentazione di stringa. Il metodo TimeSpan.ToString() predefinito restituisce un intervallo di tempo tramite un formato invariabile identico al valore restituito in versioni precedenti di .NET Framework. L'overload del metodo TimeSpan.ToString(String) consente di specificare una stringa di formato che definisce la rappresentazione di stringa dell'intervallo di tempo. L'overload del metodo TimeSpan.ToString(String, IFormatProvider) consente di specificare una stringa di formato e le impostazioni cultura le cui convenzioni di formattazione sono utilizzate per creare la rappresentazione di stringa dell'intervallo di tempo. TimeSpan supporta stringhe di formato standard e stringhe di formato personalizzate. Per ulteriori informazioni, vedere Stringhe di formato TimeSpan standard e Stringhe di formato TimeSpan personalizzate. Tuttavia, solo le stringhe di formato standard sono dipendenti dalle impostazioni cultura.

In alcuni casi, codice che esegue in modo corretto la formattazione di valori TimeSpan in .NET Framework 3.5 e versioni precedenti non funziona correttamente in .NET Framework 4. Questo problema si verifica più comunemente in codice che chiama un metodo di formattazione composita per formattare un valore TimeSpan come stringa. Nell'esempio riportato di seguito viene illustrato come un valore TimeSpan venga formattato correttamente in .NET Framework 3.5 e versioni precedenti, ma venga generata un'eccezione in .NET Framework 4 e versioni successive. Si noti che il codice tenta di formattare un valore TimeSpan tramite un identificatore di formato non supportato, ignorato in .NET Framework 3.5 e nelle versioni precedenti.

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

Se non è possibile modificare il codice, è possibile ripristinare la formattazione legacy dei valori TimeSpan in uno dei modi seguenti:

• Creando un file di configurazione che contiene l'elemento <TimeSpan_LegacyFormatMode>. L'impostazione dell'attributo enabled di questo elemento su true ripristina la formattazione legacy TimeSpan per ogni singola applicazione.

• Impostando il commutatore di compatibilità "NetFx40_TimeSpanLegacyFormatMode" quando si crea un dominio di applicazione. Questa operazione consente la formattazione di TimeSpan legacy per ogni dominio di applicazione. Nell'esempio riportato di seguito viene creato un dominio dell'applicazione che una formattazione TimeSpan legacy.

  C#

  VB

  Copia

  
  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");
     }
  }
  
  
  

  Quando il codice seguente viene eseguito nel nuovo dominio dell'applicazione, viene ripristinato il comportamento di formattazione TimeSpan legacy.

  C#

  VB

  Copia

  
  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.